Helm安装Jenkins Chart失败，模板字段解析报错求助

尝试从Jenkins官方Helm仓库安装Jenkins，执行以下命令：

helm repo update
helm install mot-jenkins jenkins/jenkins -f values-dev.yaml --dry-run

得到报错及警告输出：

coalesce.go:286: warning: cannot overwrite table with non table for jenkins.controller.initScripts (map[])
coalesce.go:286: warning: cannot overwrite table with non table for jenkins.controller.image (map[pullPolicy:Always registry:docker.io repository:jenkins/jenkins tagLabel:jdk17])
Error: INSTALLATION FAILED: template: jenkins/templates/tests/jenkins-test.yaml:34:24: executing "jenkins/templates/tests/jenkins-test.yaml" at <.Values.controller.image.registry>: can't evaluate field registry in type interface {}

此前使用旧版本Jenkins Chart时，相同的values-dev.yaml可正常工作。

原因分析 #

问题源于新版本Jenkins Helm Chart的values配置结构发生了变更，旧版本的values-dev.yaml字段格式与新版本不兼容，导致模板解析时无法正确识别字段类型。

具体修复步骤 #

1. 确认当前Chart版本
   执行以下命令查看当前使用的Jenkins Chart版本，对比旧版本确认结构差异：

   helm show chart jenkins/jenkins
   

2. 修正controller.image字段结构
   报错提示.Values.controller.image.registry无法解析，说明你的values-dev.yaml中controller.image的格式不符合新版本要求：

   • 打开values-dev.yaml，将jenkins.controller.image调整为标准嵌套map结构，注意新版本可能移除了tagLabel字段，改用tag直接指定镜像标签：

     controller:
       image:
         registry: docker.io
         repository: jenkins/jenkins
         tag: 2.440.3-jdk17  # 替换为你需要的具体版本
         pullPolicy: Always
     

3. 修正controller.initScripts字段结构
   警告提示initScripts无法用非表覆盖表，说明当前配置中jenkins.controller.initScripts是一个空map，而新版本要求它是数组（列表）结构：

   • 若不需要自定义初始化脚本，直接删除该字段即可（使用Chart默认值）；若需要添加脚本，改为数组格式：

     controller:
       initScripts:
         - |
           #!/bin/bash
           echo "自定义初始化脚本内容"
     

4. 验证修复结果
   重新执行dry-run命令验证配置是否正常：

   helm install mot-jenkins jenkins/jenkins -f values-dev.yaml --dry-run
   

5. 参考默认values配置
   若还有其他字段不兼容，可执行以下命令获取新版本Chart的默认values，对比调整你的配置文件：

   helm show values jenkins/jenkins
   

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