Jenkins Helm Chart无法更新CASC_JENKINS_CONFIG环境变量

错误原因 #

官方Jenkins Helm Chart在部署时会自动为Jenkins容器设置CASC_JENKINS_CONFIG环境变量，指向默认的JCasC配置文件路径。当你手动在values.yaml中新增同名环境变量时，Kubernetes会抛出duplicate name "CASC_JENKINS_CONFIG"错误——容器不允许存在重名的环境变量。

两种可行解决方案 #

方案1：利用Chart自带的JCasC额外配置挂载（推荐） #

官方Jenkins Helm Chart提供了原生配置项，可直接挂载额外的ConfigMap形式的JCasC文件，且会自动合并到CASC_JENKINS_CONFIG路径中，无需手动设置环境变量。

在你的values.yaml中添加如下配置：

jenkins:
  configurationAsCode:
    configMaps:
      # 挂载第一个拆分的ConfigMap
      - name: "jenkins-casc-part1"
        key: "casc-part1.yaml"
      # 挂载第二个拆分的ConfigMap
      - name: "jenkins-casc-part2"
        key: "casc-part2.yaml"

Chart会自动将这些配置文件挂载到容器内的/var/jenkins_home/casc_configs/目录下，并自动更新CASC_JENKINS_CONFIG环境变量，包含所有挂载的配置文件路径，完全避免重复定义问题。

方案2：覆盖默认的CASC_JENKINS_CONFIG环境变量 #

如果需要手动指定所有配置路径，可以直接覆盖Chart默认的环境变量定义，注意要包含原默认配置文件的路径，再追加自定义路径（用逗号分隔多个路径）。

在values.yaml中配置：

jenkins:
  controller:
    env:
      - name: CASC_JENKINS_CONFIG
        # 格式：默认路径,自定义路径1,自定义路径2
        value: "/var/jenkins_home/casc_configs/config.yaml,/var/jenkins_home/custom-casc/casc-part1.yaml,/var/jenkins_home/custom-casc/casc-part2.yaml"

注意：

• 确保自定义路径与你挂载ConfigMap时指定的容器内路径一致
• 必须保留原默认路径/var/jenkins_home/casc_configs/config.yaml，否则会丢失Chart自带的基础JCasC配置

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