Helm模板重构：合并单对象与多对象配置模板

针对你提到的两个模板逻辑重复的问题，最直接的解决方式是把处理单个Config对象的核心逻辑抽成局部模板（Partial Template），然后让单个配置和数组配置的模板都复用这个局部逻辑。具体步骤如下：

1. 创建局部模板文件 #

在templates目录下新建一个以_开头的模板文件（Helm约定下划线开头的文件是局部模板，不会被直接渲染成K8s资源），比如_config_item.tpl。把原来两个模板中处理单个Config对象的所有重复逻辑都移到这里：

{{/* 定义处理单个Config对象的局部模板，接收一个Config对象作为输入参数 */}}
{{- define "mychart.config.item" -}}
# 这里放原来两个模板里重复的逻辑，比如：
key: {{ .key }}
value: {{ .value }}
path: {{ .path | default "/etc/config" }}
enabled: {{ .enabled | default true }}
{{- end -}}

注意：模板命名最好带上你的Chart名称前缀（比如mychart.），避免和其他Chart的局部模板重名。

2. 修改单个配置模板（config.yaml） #

原来的service.config逻辑直接替换为调用上面的局部模板，传入单个Config对象即可：

service:
  config:
    {{- if .Values.config.enabled }}
    {{- include "mychart.config.item" .Values.config | nindent 4 }}
    {{- end }}

这里用include而不是template，因为include会返回渲染后的字符串，配合nindent可以方便调整缩进，保证YAML格式正确。

3. 修改数组配置模板（configs.yaml） #

遍历configs数组时，对每个元素调用局部模板：

service:
  configs:
    {{- range .Values.configs }}
    - {{- include "mychart.config.item" . | nindent 6 }}
    {{- end }}

循环里的nindent 6是因为数组元素前面有- ，需要多缩进2个空格，你可以根据实际YAML结构调整缩进数值。

额外优化点 #

• 如果单个配置和数组配置有少量差异逻辑，可以在局部模板里通过条件判断处理，比如：

  {{- define "mychart.config.item" -}}
  key: {{ .key }}
  value: {{ .value }}
  {{- if .isArrayItem }}
  # 只有数组元素需要的逻辑
  priority: {{ .priority | default 10 }}
  {{- end }}
  {{- end -}}
  

  调用时通过传字典参数传递额外标识：

  # config.yaml里调用
  {{- include "mychart.config.item" (dict "key" .Values.config.key "value" .Values.config.value "isArrayItem" false) }}
  

• 如果需要在局部模板里访问全局变量（比如.Release.Name、.Values.global），可以把全局上下文和Config对象一起传入：

  {{- include "mychart.config.item" (dict "config" .Values.config "root" .) }}
  

  然后在局部模板里用.root.Release.Name访问全局变量。

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