在Helm values.yaml中使用模板变量传递输入的最优方案问询

首先，你遇到的错误根源很明确：Helm的values.yaml是静态配置文件，Helm不会在这个文件中解析模板表达式（比如{{ .Release.Name }}）。YAML解析器看到这些花括号会认为是无效语法，所以抛出了did not find expected key的错误。

接下来，我给你几个从优到次的解决方案，覆盖不同使用场景：

方案1：通过helm install命令行--set传递动态值（最直接，无需修改图表） #

这是最简单的方式，直接在安装时通过--set参数传入父图表Zookeeper的完整DNS名称。Bitnami的Zookeeper图表默认会创建{{ .Release.Name }}-zookeeper-headless的无头服务，我们可以结合Helm的模板渲染获取这个名称：

helm install myapp ./myapp \
  # 启用父图表的Zookeeper
  --set zookeeper.enabled=true \
  # 禁用Kafka自带的Zookeeper
  --set kafka.zookeeper.enabled=false \
  # 传入父图表Zookeeper的无头服务地址
  --set kafka.externalZookeeper.servers=$(helm template --name-template myapp -s '{{ template "zookeeper.fullname" . }}' ./myapp)-headless \
  # 禁用internaldep自带的Zookeeper
  --set internaldep.zookeeper.enabled=false

命令中，helm template --name-template myapp -s '{{ template "zookeeper.fullname" . }}' ./myapp会先渲染出父图表Zookeeper的完整名称，再拼接-headless作为Kafka的外部Zookeeper地址。

方案2：使用动态Values文件（适合重复部署场景） #

如果需要多次部署，不想每次都写长命令，可以创建一个动态Values文件，用Helm的tpl函数渲染模板表达式：

1. 在父图表目录下创建dynamic-values.yaml：

kafka:
  externalZookeeper:
    servers: "{{ template \"zookeeper.fullname\" . }}-headless"

2. 安装时结合静态values.yaml和动态渲染后的Values文件：

helm install myapp ./myapp \
  --values values.yaml \
  --values <(helm template -s dynamic-values.yaml ./myapp)

这里<(...)是shell进程替换语法，会先渲染动态Values文件，再传给Helm使用。

方案3：通过Kubernetes Patch覆盖Kafka环境变量（最灵活，适合复杂场景） #

如果需要更精细的控制，可以在父图表中创建一个Patch文件，直接修改Kafka的StatefulSet配置，强制指定Zookeeper地址：

在父图表的templates目录下创建kafka-zookeeper-override.yaml：

{{- if .Values.kafka.enabled -}}
apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: {{ template "kafka.fullname" . }}
  labels: {{- include "kafka.labels" . | nindent 4 }}
spec:
  template:
    spec:
      containers:
        - name: kafka
          env:
            - name: KAFKA_CFG_ZOOKEEPER_CONNECT
              value: {{ template "zookeeper.fullname" . }}-headless:2181
{{- end -}}

Helm会自动将这个Patch合并到Kafka子图表的StatefulSet中，直接覆盖环境变量的值，无需依赖Kafka的externalZookeeper配置。

方案4：修改内部图表（如果有权限） #

如果你们团队可以修改internaldep图表，建议统一它的Zookeeper配置方式，让它和Kafka一样支持externalZookeeper.servers参数，这样就能在父图表中统一配置所有子图表的外部Zookeeper地址，保持配置一致性。

内容的提问来源于stack exchange，提问作者Scott Crooks