Helm部署Kibana至EKS遇InvalidImageName错误：镜像名称解析异常

问题核心 #

部署时镜像被解析为map[registry:abc.xyz.com repository:bitnami/kibana tag:8-debian-12]:8.5.1，本质是Helm模板将镜像配置对象直接转成字符串，再错误拼接了values.yaml中的默认tag值，导致镜像格式完全不符合Docker规范。

排查与修复步骤 #

1. 检查Kibana Chart的模板渲染逻辑 #

问题大概率出在Kibana Chart的部署模板（如templates/deployment.yaml）中镜像字段的写法上：

• 错误写法示例：

  image: "{{ .Values.image }}:{{ .Values.image.tag }}"
  

  这种写法会把整个image对象（map结构）直接转为字符串，再拼接默认的image.tag，就会出现你看到的畸形镜像名。
• 正确写法应该是拼接对象内的具体字段：

  image: "{{- if .Values.image.registry }}{{ .Values.image.registry }}/{{ end }}{{ .Values.image.repository }}:{{ .Values.image.tag }}"
  

  （if判断是为了兼容无registry的场景）

2. 验证Jenkinsfile中的Helm参数传递 #

确保你在Helm命令中正确传递了镜像的三个字段，而非错误地传递整个对象结构：

• 正确的--set参数格式：

  helm upgrade --install kibana ./kibana-chart \
    --set image.registry=abc.xyz.com \
    --set image.repository=bitnami/kibana \
    --set image.tag=8-debian-12 \
    # 其他部署参数
  

• 避免用类似--set image={registry:abc.xyz.com,...}的写法，这种格式容易导致Helm解析对象结构异常。

3. 对比ES与Kibana的Chart配置差异 #

既然ES部署正常，说明你的Jenkins参数传递逻辑是可行的，重点对比：

• ES和Kibana的Chart模板中镜像字段的渲染代码
• 两者values.yaml中image配置的结构是否一致（比如是否ES的Chart用了相同的字段命名：registry/repository/tag）

4. 本地预渲染模板快速验证 #

用Helm的template命令本地渲染模板，直接查看生成的镜像字段是否正确：

helm template ./kibana-chart \
  --set image.registry=abc.xyz.com \
  --set image.repository=bitnami/kibana \
  --set image.tag=8-debian-12

如果输出的镜像名还是畸形，直接定位到模板文件修改即可；如果输出正常，说明问题出在Jenkins的参数传递或环境变量上。

额外注意点 #

你提到使用Elastic官方的Kibana 8.5.1 Chart，但镜像用的是Bitnami的，需要确认Elastic官方Chart的image字段命名是否和你传递的参数匹配（官方默认是docker.elastic.co/kibana/kibana，字段结构是image.registry/repository/tag，和你用的Bitnami镜像结构一致，所以重点还是模板写法）。

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