Helm创建Secret报错：无法反序列化字符串/对象为map[string][]uint8

错误根源 #

Kubernetes Secret的data字段有严格格式要求：每个键对应的值必须是base64编码的字符串（对应Go类型map[string][]uint8）。你的模板存在两个核心问题：

• 在data下直接嵌套了YAML对象（{{ $relatedClusters.name }}对应的Config结构），而非base64编码的字符串，导致K8s无法将其反序列化为预期类型
• current-context使用明文字符串，未做base64编码，同样不符合Secret格式规范

修正后的Helm模板 #

{{- range $relatedClusters := .Values.relatedClusters }}
apiVersion: v1
kind: Secret
metadata:
  name: {{ $relatedClusters.name }}
  namespace: {{ $.Values.project }}
data:
  {{ $relatedClusters.name }}: |-
    {{- $clusterName := (split "-" $relatedClusters.name)._0 }}
    {{- $config := dict 
        "apiVersion" "v1" 
        "kind" "Config"
        "clusters" (list (dict 
            "name" $clusterName 
            "cluster" (dict 
                "certificate-authority-data" $relatedClusters.certData 
                "server" $relatedClusters.server
            )
        ))
        "contexts" (list (dict 
            "name" (printf "istiod-basic@%s" $clusterName) 
            "context" (dict 
                "cluster" $clusterName 
                "namespace" "istio-system" 
                "user" "istiod-basic"
            )
        ))
        "users" (list (dict 
            "name" "istiod-basic" 
            "user" (dict "token" $relatedClusters.token)
        ))
        "current-context" (printf "istiod-basic@%s" $clusterName)
    }}
    {{- $config | toYaml | b64enc }}
{{- end }}

关键改动说明 #

1. Config结构转base64字符串：
   • 用dict构建Config对象，通过toYaml转为纯文本YAML
   • 再通过b64enc函数对YAML字符串做base64编码，完全匹配Secretdata字段的格式要求
2. 整合current-context到Config结构：
   • 原模板中current-context是data下的独立键，实际它属于Config的一部分，将其纳入Config结构后统一编码，避免格式冲突
3. 简化变量逻辑：提前定义$clusterName变量，避免重复调用split函数，提升模板可读性

验证方法 #

1. 运行helm template . --dry-run查看生成的Secret内容，确认data下所有值均为base64编码字符串
2. 部署后执行oc get secret <secret-name> -o yaml，检查data字段格式是否合规
3. 用oc extract secret <secret-name> --to=-验证解码后的Config内容是否符合预期

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