如何通过GitOps向Helm列表添加自定义元素且不覆盖默认值

你的问题核心在于Helm对列表的处理是整体替换而非合并，所以当你在GitOps流程中自定义values.yaml的extraEnv列表时，会直接覆盖Chart默认values里的同名列表。下面给你两种可行的解决思路：

方法一：拆分默认与自定义环境变量（推荐） #

把默认环境变量和用户自定义的环境变量分开定义，在模板里合并输出：

1. 修改Chart的默认values.yaml
   将原有的默认环境变量移到新的defaultEnv字段，extraEnv默认留空：

container:
  # Chart内置的默认环境变量，不会被用户自定义values覆盖
  defaultEnv:
    - name: SECRET_1
      valueFrom:
        secretKeyRef:
          name: tls-secret-1
          key: ca.crt
    - name: SECRET_2
      valueFrom:
        secretKeyRef:
          name: tls-secret-2
          key: ca.crt
  # 用户自定义的环境变量追加在这里
  extraEnv: []

2. 修正模板文件
   在模板里先遍历输出默认的defaultEnv，再遍历输出用户自定义的extraEnv：

container:
  extraEnv:
    {{- range .Values.container.defaultEnv }}
    - {{ . | toYaml | nindent 12 | trim }}
    {{- end }}
    {{- range .Values.container.extraEnv }}
    - {{ . | toYaml | nindent 12 | trim }}
    {{- end }}

这样用户在GitOps中自定义values时，只需要添加extraEnv的新元素即可，不会影响默认的环境变量：

# 用户自定义values.yaml
container:
  extraEnv:
    - name: CUSTOM_SECRET
      valueFrom:
        secretKeyRef:
          name: my-custom-secret
          key: token

方法二：支持同名环境变量覆盖（进阶） #

如果需要允许用户覆盖默认的同名环境变量（比如默认的SECRET_1需要替换为自定义的），可以先把默认环境变量转成字典，再合并用户的配置，最后转回列表：

{{- /* 将默认环境变量转成字典，key为环境变量名 */ -}}
{{- $defaultEnvDict := dict -}}
{{- range .Values.container.defaultEnv }}
{{- $_ := set $defaultEnvDict .name . -}}
{{- end -}}

{{- /* 合并用户自定义的环境变量，同名的会覆盖默认值 */ -}}
{{- range .Values.container.extraEnv }}
{{- $_ := set $defaultEnvDict .name . -}}
{{- end -}}

container:
  extraEnv:
    {{- /* 遍历合并后的字典，生成环境变量列表 */ -}}
    {{- range $name, $env := $defaultEnvDict }}
    - name: {{ $name }}
      {{- /* 去掉已经单独输出的name字段，避免重复 */ -}}
      {{- omit $env "name" | toYaml | nindent 12 | trim }}
    {{- end }}

这种方式下，如果用户添加了同名的环境变量，会自动覆盖默认值，否则追加新的变量。

内容的提问来源于stack exchange，提问作者hb-h