Helm安装传递JSON字符串参数报错，结合range循环求解决方案

问题原因 #

直接在命令行用--set-string传JSON数组时，shell会把数组里的逗号、空格当成命令参数分隔符，导致Helm没法正确识别完整的JSON结构，从而抛出参数数量异常的错误。

适配方案（兼容Chart的range循环逻辑） #

方案1：单引号包裹JSON+模板中解析处理 #

1. 修改Helm命令：用单引号把JSON数组整个包起来，避免shell拆分参数

$ helm install mychart-test mychart -n mft-system -f mychart/custom-values.yaml \
  --set-string .Values.job.pod.env.server_deploy=true \
  --set-string .Values.job.pod.env.server_custom_values='[{"name":"configmap.properties.portVersion", "value":"true"}, {"name":"configmap.properties.storageVersion", "value":"true"}]' \
  --dry-run

2. 调整Chart模板：因为传入的是JSON字符串，需要先解析成对象数组再用range遍历，同时保留其他环境变量的处理：

{{- /* 处理普通键值对形式的环境变量 */}}
{{- range $key, $val := .Values.job.pod.env }}
{{- if ne $key "server_custom_values" }}
- name: {{ $key }}
  value: {{ $val | quote }}
{{- end }}
{{- end }}

{{- /* 解析并遍历server_custom_values数组 */}}
{{- if .Values.job.pod.env.server_custom_values }}
{{- range $item := .Values.job.pod.env.server_custom_values | fromJson }}
- name: {{ $item.name }}
  value: {{ $item.value | quote }}
{{- end }}
{{- end }}

方案2：用临时values文件传递数组 #

如果命令行传JSON太麻烦，直接写个临时values文件（比如temp-env.yaml）：

job:
  pod:
    env:
      server_deploy: true
      server_custom_values:
        - name: "configmap.properties.portVersion"
          value: "true"
        - name: "configmap.properties.storageVersion"
          value: "true"

然后执行Helm命令时多指定这个文件：

$ helm install mychart-test mychart -n mft-system -f mychart/custom-values.yaml -f temp-env.yaml --dry-run

这种方式不用改模板，原来的range循环可以直接正常遍历数组。

方案3：用Helm原生的--set数组语法 #

Helm的--set支持直接定义数组元素，不用传JSON，适合数组元素不多的场景：

$ helm install mychart-test mychart -n mft-system -f mychart/custom-values.yaml \
  --set-string job.pod.env.server_deploy=true \
  --set job.pod.env.server_custom_values[0].name=configmap.properties.portVersion \
  --set job.pod.env.server_custom_values[0].value=true \
  --set job.pod.env.server_custom_values[1].name=configmap.properties.storageVersion \
  --set job.pod.env.server_custom_values[1].value=true \
  --dry-run

同样不需要修改模板，原有的range循环逻辑完全兼容。

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