Helm部署突发报错：error calling index: value is nil; should be of type string

问题详情 #

近期执行Helm部署命令时突然触发报错，此前部署一直正常：

<index .Values.common .Values.deploy_target>: error calling index: value is nil; should be of type string

相关代码及命令如下：

deployment.yaml 代码片段 #

# Common Environment variables
          {{- with (index .Values.common .Values.deploy_target) }}
            {{- range .env_vars }}
            - name: {{.name}}
              value: "{{.value}}"
            {{- end }}
          {{- end }}

values.yaml 代码片段 #

common:
  dev:
    env_vars:
      - name: foo
        value: bar
      - name: foo
        value: bar
  qa:
    env_vars:
      - name: foo
        value: bar
      - name: foo
        value: bar
  production:
    env_vars:
      - name: foo
        value: bar
      - name: foo
        value: bar

部署命令 #

helm upgrade --install foo-bar .helm/folder -n beta

错误原因 #

报错核心是index函数的第二个参数.Values.deploy_target为nil（未定义）。index函数要求第二个参数必须是字符串类型，用来从.Values.common中匹配对应的环境配置（dev/qa/production）。之前部署正常是因为当时通过命令行参数、默认values或其他方式传入了deploy_target值，当前部署未传递该参数导致报错。

解决方案 #

以下三种方案任选其一即可：

1. 命令行直接传递环境参数 #

在部署命令中通过--set指定deploy_target的值，比如部署到dev环境：

helm upgrade --install foo-bar .helm/folder -n beta --set deploy_target=dev

根据实际需求替换dev为qa或production。

2. 在values.yaml中设置默认环境 #

在values.yaml顶部添加默认的deploy_target值，避免每次命令行传递：

# 新增默认环境配置
deploy_target: dev

common:
  dev:
    env_vars:
      - name: foo
        value: bar
      - name: foo
        value: bar
  # 其余qa/production配置保持不变

3. 模板中增加空值判断（容错处理） #

修改deployment.yaml中的模板逻辑，先判断deploy_target是否存在且有效，再执行后续渲染，避免空值报错：

# Common Environment variables
          {{- if and .Values.deploy_target (index .Values.common .Values.deploy_target) }}
            {{- range (index .Values.common .Values.deploy_target).env_vars }}
            - name: {{.name}}
              value: "{{.value}}"
            {{- end }}
          {{- end }}

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