如何通过Helm在K8s ConfigMap中正确表示Go Map对象

问题根源 #

直接在Helm模板中输出{{ .Values.config.myconfig }}时，Helm会调用Go默认的字符串格式化逻辑，将map/slice转为Go语法风格的字符串（比如map[1:[2] 2:[1]]），而Go的mapstructure库需要标准YAML格式的配置内容，因此解析失败。

解决方案：使用Helm的toYaml过滤器 #

通过toYaml过滤器将Values中的配置序列化为标准YAML格式后输出到ConfigMap，即可让mapstructure正确解析。

场景1：Go结构为map[int64][]int64 #

调整Helm ConfigMap模板

apiVersion: v1
kind: ConfigMap
metadata:
  name: example-config
data:
  config.yaml: |
    my-config: {{ .Values.config.myconfig | toYaml | nindent 4 }}

（nindent 4用于添加合法缩进，保证YAML格式规范）

对应的Values.yaml配置

config:
  myconfig:
    1: [2]
    2: [1]

渲染后的ConfigMap内容

my-config:
    1:
    - 2
    2:
    - 1

此格式完全符合mapstructure对map[int64][]int64结构的解析要求。

场景2：Go结构为[]MyConfigItem结构体数组 #

调整Helm ConfigMap模板

同样使用toYaml过滤器：

apiVersion: v1
kind: ConfigMap
metadata:
  name: example-config
data:
  config.yaml: |
    my-config: {{ .Values.config.myconfig | toYaml | nindent 4 }}

对应的Values.yaml配置

改为YAML数组格式：

config:
  myconfig:
    - first-part: 1
      second-part: [2]
    - first-part: 2
      second-part: [1]

渲染后的ConfigMap内容

my-config:
    - first-part: 1
      second-part:
      - 2
    - first-part: 2
      second-part:
      - 1

该格式可被mapstructure正确解析为[]MyConfigItem数组。

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