使用Helm向Kubernetes环境变量写入JSON时遇解组错误求助

问题原因 #

当.Values.stuff.nodeHosts是数组类型时，toJson过滤器会输出不带引号的JSON数组（例如["host1", "host2"]）。在YAML语法中，这个内容会被解析为数组类型，但Kubernetes的EnvVar.value字段要求必须是字符串类型，因此API Server会抛出类型不匹配的错误。而helm install/upgrade --dry-run仅完成模板渲染，未经过Kubernetes API的严格类型校验，所以不会暴露这个问题。

解决方案 #

需要确保渲染后的JSON内容被识别为字符串，以下两种方法都可以解决：

方法1：使用quote过滤器包裹JSON结果 #

通过quote把toJson生成的JSON内容转为带引号的字符串，YAML解析后会将其识别为字符串类型：

containers:
  - name: mycontainer
    env:
      - name: NODE_HOSTS
        value: {{ .Values.stuff.nodeHosts | toJson | quote }}

方法2：使用printf强制转为字符串 #

利用printf "%s"将JSON结果格式化为字符串，同样能满足Kubernetes的类型要求：

containers:
  - name: mycontainer
    env:
      - name: NODE_HOSTS
        value: {{ printf "%s" (.Values.stuff.nodeHosts | toJson) }}

应用上述修改后，渲染后的环境变量值会是带引号的JSON字符串（例如"[\"host1\",\"host2\"]"），既符合Kubernetes的字段类型要求，也能被pydantic正常解析为数组。

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