如何在Helm模板中读取values.yaml字典内的标签值并注入Pod反亲和配置？

核心注意事项 #

• YAML 中单行花括号格式（flow style）的字典与多行块格式字典在 Helm 解析时无差异，均为标准键值对结构，可直接读取。
• 目标键app.kubernetes.io/name包含点、斜杠特殊字符，不能使用链式点语法取值——Go 模板的链式点会将该字符串拆分为多级嵌套路径查找，最终返回空值。
• K8s 配置中matchExpressions.values字段为字符串数组类型，不能直接传入单个字符串，需将提取到的值包装为数组结构。

正确取值语法 #

使用方括号索引语法访问带特殊字符的字典键，搭配 quote 函数处理字符串避免格式错误，最终输出单元素数组：
values: [{{ .Values.selectorLabels["app.kubernetes.io/name"] | quote }}]

如果需要兼容性更强的多行数组写法（适配后续多值扩展场景），可使用 Helm 内置的list+toYaml组合，搭配缩进控制函数对齐格式：
values: {{ list .Values.selectorLabels["app.kubernetes.io/name"] | toYaml | nindent 12 }}

填充完成的完整模板片段 #

{{- if .Values.affinity.podAntiAffinity.preferred == true }}
        podAntiAffinity:
          preferredDuringSchedulingIgnoredDuringExecution:
          - weight: 100
            podAffinityTerm:
              labelSelector:
                 matchExpressions:
                 - key: app.kubernetes.io/name
                   operator: In
                   values: [{{ .Values.selectorLabels["app.kubernetes.io/name"] | quote }}]
              topologyKey: "kubernetes.io/hostname"
{{- end }}

渲染效果验证 #

基于提供的 values 配置，模板渲染后对应片段会生成符合 K8s 规范的 YAML 结构：

podAntiAffinity:
  preferredDuringSchedulingIgnoredDuringExecution:
  - weight: 100
    podAffinityTerm:
      labelSelector:
         matchExpressions:
         - key: app.kubernetes.io/name
           operator: In
           values: ["tinyurl"]
      topologyKey: "kubernetes.io/hostname"

兜底优化（可选） #

如果担心 values 中未配置对应键导致渲染空值，可以添加默认值逻辑：
values: [{{ .Values.selectorLabels["app.kubernetes.io/name"] | default .Release.Name | quote }}]
当键不存在时，会自动使用当前 Helm Release 的名称作为匹配值，避免配置失效。

内容的提问来源于stack exchange，提问作者Gaurav Agnihotri