如何在Helm钩子脚本中动态获取Release命名空间与Patroni集群名

1. 修复ConfigMap中Helm模板变量不生效的问题 #

ConfigMap作为post-install钩子时，必须确保脚本内容被Helm正确渲染。核心要点是用**多行文本标记（|或>）**保留脚本格式，同时保证模板变量未被转义。示例模板如下：

apiVersion: v1
kind: ConfigMap
metadata:
  name: {{ .Release.Name }}-post-install-scripts
  namespace: {{ .Release.Namespace }}
  annotations:
    "helm.sh/hook": post-install
    "helm.sh/hook-weight": "1"
    "helm.sh/hook-delete-policy": hook-succeeded,hook-failed
data:
  init-db.sh: |
    #!/bin/bash
    # 这里的模板变量会被Helm自动替换
    NAMESPACE="{{ .Release.Namespace }}"
    CLUSTER_NAME="{{ .Release.Name }}-patroni"
    # 后续执行逻辑...

注意：如果ConfigMap是单独的模板文件，不要用--set等方式覆盖其内容，避免Helm跳过模板渲染；同时确认钩子注解helm.sh/hook配置正确，Helm仅处理带该注解的资源的模板解析。

2. 动态生成Patroni集群名 #

直接用{{ .Release.Name }}-patroni即可实现动态生成——Helm安装时会自动将{{ .Release.Name }}替换为实际的Release名称（比如Release名为t1，渲染后集群名就是t1-patroni），只需将这个变量嵌入到ConfigMap的脚本内容中即可。

3. 在Patroni主节点Pod执行命令 #

Patroni主节点的识别有两种可靠方式，根据你的集群配置选择：

方式一：通过标签筛选主节点 #

Patroni通常会给主节点Pod打上专属标签（比如role: master或patroni.role: master），可以用kubectl筛选：

# 在脚本中获取主节点Pod名
MASTER_POD=$(kubectl get pods -n $NAMESPACE -l "app=$CLUSTER_NAME,role=master" -o jsonpath='{.items[0].metadata.name}')

# 执行数据库命令
kubectl exec -n $NAMESPACE $MASTER_POD -- psql -U postgres -c "CREATE DATABASE mydb;"

注：标签键值对需与你的Patroni Chart配置一致，比如部分集群用patroni_cluster=$CLUSTER_NAME + patroni_role=master，需按需调整。

方式二：通过Patroni API查询主节点 #

如果Patroni集群暴露了内部API，直接调用API获取主节点更可靠（避免标签同步延迟）：

# 调用Patroni内部API获取主节点Pod名
MASTER_POD=$(kubectl exec -n $NAMESPACE $CLUSTER_NAME-0 -- curl -s http://localhost:8008/cluster | jq -r '.leader.name')

# 执行数据库命令
kubectl exec -n $NAMESPACE $MASTER_POD -- psql -U postgres -c "CREATE DATABASE mydb;"

完整ConfigMap+Job示例 #

如果需要用Job执行脚本，还需配套创建Job资源（确保容器包含kubectl和jq工具，比如用bitnami/kubectl镜像）：

# ConfigMap部分（同上）
---
apiVersion: batch/v1
kind: Job
metadata:
  name: {{ .Release.Name }}-post-install-job
  namespace: {{ .Release.Namespace }}
  annotations:
    "helm.sh/hook": post-install
    "helm.sh/hook-weight": "2"
    "helm.sh/hook-delete-policy": hook-succeeded,hook-failed
spec:
  template:
    spec:
      containers:
      - name: init-db
        image: bitnami/kubectl:latest
        command: ["/bin/bash", "/scripts/init-db.sh"]
        volumeMounts:
        - name: script-volume
          mountPath: /scripts
      volumes:
      - name: script-volume
        configMap:
          name: {{ .Release.Name }}-post-install-scripts
          defaultMode: 0755
      restartPolicy: OnFailure

关键注意事项 #

• 确保Job容器有权限执行kubectl命令（可通过ServiceAccount配置RBAC权限）。
• 敏感数据（如数据库密码）不要放在ConfigMap，改用Secret挂载。
• 调整hook-weight值，确保钩子在Patroni集群完全启动后执行（比如设为2，晚于Patroni的启动钩子）。

内容的提问来源于stack exchange，提问作者Rutuja Kawade