使用dict、split、range编写Helm模板时出现缩进错误如何解决

根因说明 #

你遇到的报错本质不是真的存在制表符，而是模板的空白控制逻辑错误，多组循环渲染后产生了不符合YAML规范的缩进错乱，被解析器误判为非法制表符。单组配置时空白偏差不影响缩进规则，因此可以正常执行，多组循环时多余空白累积就触发了报错。另外注意你给出的示例中values.yaml的Deployment首字母大写，和模板中调用的.Values.deployment小写不一致，也是潜在的配置不生效风险点。

修正方案 #

1. 调整模板空白控制 #

将同一行堆叠的模板标签拆分为独立行，使用{{-语法正确清除多余空白，修正后的deployment.yaml对应段如下：

volumeMounts:
    {{- if .Values.deployment.hostPath }}
    {{- $dict := split ":" .Values.deployment.hostPath }}
    {{- range $idx, $val := $dict }}
    {{- $mnt := split "," $val }}
    - mountPath: {{ $mnt._1 }}
      name: {{ $mnt._0 }}
    {{- end }}
    {{- end }}
  volumes:
  {{- if .Values.deployment.hostPath }}
  {{- $dict := split ":" .Values.deployment.hostPath }}
  {{- range $idx, $val := $dict }}
  {{- $mnt := split "," $val }}
  - name: {{ $mnt._0 }}
    hostPath:
      path: {{ $mnt._2 }}
      {{- if $mnt._3 }}
      type: {{ $mnt._3 }}
      {{- end }}
  {{- end }}
  {{- end }}

2. 多组配置写法示例 #

values.yaml中多组冒号分隔的配置参考如下，注意和模板调用的字段大小写保持一致：

deployment:
  hostPath: test-host-path,/path/on/pod1,/path/on/node1,Directory:test-host-path2,/path/on/pod2,/path/on/node2,Directory

3. 本地渲染验证 #

如果调整后仍有报错，可以先执行本地渲染命令直接查看生成的YAML内容，快速定位缩进错误位置：
helm template [你的Release名称] [你的Chart本地路径]

4. 优化建议（可选） #

这种多卷配置更推荐用数组格式定义，比字符串分割的方式可读性更高、容错性更强，参考配置如下：
values.yaml：

deployment:
  hostPathVolumes:
  - name: test-host-path
    mountPath: /path/on/pod
    hostPath: /path/on/node
    type: Directory
  - name: test-host-path-2
    mountPath: /path/on/pod2
    hostPath: /path/on/node2
    type: Directory

对应模板逻辑：

volumeMounts:
    {{- range .Values.deployment.hostPathVolumes }}
    - mountPath: {{ .mountPath }}
      name: {{ .name }}
    {{- end }}
  volumes:
  {{- range .Values.deployment.hostPathVolumes }}
  - name: {{ .name }}
    hostPath:
      path: {{ .hostPath }}
      {{- if .type }}
      type: {{ .type }}
      {{- end }}
  {{- end }}

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