Helm/Go模板中如何将嵌套YAML转换为属性式格式？

方法一：递归模板遍历（推荐） #

Helm没有内置函数直接实现这个转换，但可以通过自定义递归模板来完成。

1. 在Chart的templates目录下创建_helpers.tpl文件，添加以下模板片段：

{{- define "flattenYaml" -}}
{{- $prefix := .prefix -}}
{{- $data := .data -}}
{{- range $key, $value := $data -}}
  {{- if kindIs "map" $value -}}
    {{- include "flattenYaml" (dict "prefix" (printf "%s.%s" $prefix $key) "data" $value) -}}
  {{- else -}}
{{ printf "%s.%s: %v" $prefix $key $value | indent 2 }}
  {{- end -}}
{{- end -}}
{{- end -}}

2. 在你的ConfigMap.yaml中调用这个模板：

data:
{{- include "flattenYaml" (dict "prefix" "" "data" .Values.configuration) | trimPrefix " ." }}

这里的trimPrefix " ."是为了移除根节点路径开头多余的点，确保生成的属性格式正确。

方法二：外部工具预处理（可选） #

如果你的CI/CD流程允许，可以用yq这类工具提前将values.yaml中的嵌套结构扁平化为点分隔格式，再传入Helm渲染：

yq eval '.configuration |= flatten(pathsep=".")' values.yaml

这种方法需要额外依赖外部工具，灵活性不如模板递归，仅适合特定场景。

注意事项 #

如果你的配置值中包含点（.）这类特殊字符，需要在递归模板中添加转义逻辑，避免路径解析混乱。

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