Helm Chart无法读取prod环境静态IP值，部署失败求助

问题描述 #

在GKE中为LoadBalancer类型的服务分配静态IP，将IP信息按sandbox、dev、test、prod四个环境分别配置在values.yaml的service1和service2字段中。sandbox、dev、test环境部署正常，但prod环境部署失败，报错提示<.Values.ip.prod.service2>为nil指针。

相关配置 #

values.yaml #

ip:
  sandbox:
    service1: xxx.xxx.201.74
    service2: xxx.xxx.80.114
  dev:
    service1: xxx.xxx.249.203
    service2: xxx.xxx.197.77
  test:
    service1: xxx.xxx.123.212
    service2: xxx.xxx.194.133
  prod:
    service1: xxx.xx.244.211
    service2: xxx.xxx.207.177

service2-service.yaml模板 #

apiVersion: v1
kind: Service
metadata:
  annotations:
    appName: {{ include "common.fullname" . }}
    componentName: service2
  labels:
    io.kompose.service: service2
  name: service2
spec:
  ports:
  - name: "{{ .Values.service.service2.ports.name }}"
    port: {{ .Values.service.service2.ports.port }}
    protocol: {{ .Values.service.service2.ports.protocol }}
    targetPort: {{ .Values.service.service2.ports.port }}
  type: LoadBalancer
{{ if eq .Values.target.deployment.namespace "sandbox" }}
  loadBalancerIP: {{ .Values.ip.sandbox.service2 }}
{{ else if eq .Values.target.deployment.namespace "dev" }}
  loadBalancerIP: {{ .Values.ip.dev.service2 }}
{{ else if eq .Values.target.deployment.namespace "test" }}
  loadBalancerIP: {{ .Values.ip.test.service2 }}
{{ else if eq .Values.target.deployment.namespace "prod" }}
  loadBalancerIP: {{ .Values.ip.prod.service2 }}
{{ else }}
{{ end }}
  selector:
    io.kompose.service: service2
status:
  loadBalancer: {}

报错信息 #

Error: UPGRADE FAILED: template: chart-v1/templates/service2-service.yaml:24:28: executing "chart-v1/templates/service2-service.yaml" at <.Values.ip.prod.service2>: nil pointer evaluating interface {}.service2
helm.go:94: [debug] template: chart-v1/templates/service2-service.yaml:24:28: executing "chart-v1/templates/service2-service.yaml" at <.Values.ip.prod.service2>: nil pointer evaluating interface {}.service2

问题原因及解决方案 #

可能的原因 #

1. 实际部署的values.yaml与提供的不一致：部署prod环境时，可能使用了错误的values文件，或者prod环境的values被其他方式（如--set参数、分层values文件）覆盖，导致.Values.ip.prod节点不存在或service2字段缺失。
2. values.yaml语法错误：虽然提供的values.yaml看起来格式正确，但实际文件中可能存在缩进错误、注释覆盖或特殊字符问题，导致Helm无法正确解析prod.service2的值。
3. 命名空间匹配问题：模板中判断的是.Values.target.deployment.namespace等于"prod"，但实际部署时该变量值可能是其他拼写（如"production"），不过报错明确指向.Values.ip.prod.service2，说明条件已匹配到prod分支，此可能性较低。

解决方案 #

1. 验证部署时使用的values文件：执行部署命令时，确认指定的values文件是包含prod环境配置的正确版本，可通过helm get values <release-name>查看当前生效的配置。
2. 检查values.yaml语法：使用yamllint工具检查values.yaml的语法正确性，确保prod节点下的service2字段缩进正确、无语法错误。
3. 优化模板变量引用方式：将硬编码的环境判断改为动态引用，避免因环境名称拼写错误或新增环境导致的问题，修改后的loadBalancerIP配置如下：

{{- $namespace := .Values.target.deployment.namespace }}
{{- if index .Values.ip $namespace "service2" }}
  loadBalancerIP: {{ index .Values.ip $namespace "service2" }}
{{- end }}

这种方式会根据命名空间动态获取对应的IP，同时通过index函数安全访问，避免nil指针错误。

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