Jenkins流水线执行Helm升级：仅ECR中Docker镜像变更不生效

核心原因 #

Helm 仅会在渲染后的 Kubernetes 资源清单发生变化时触发更新。如果仅镜像内容变更但镜像标签未修改，或者 Helm Chart 模板中镜像相关字段未随镜像更新而变动，Kubernetes 会判定 Pod 模板无变化，不会触发滚动更新——哪怕你设置了 imagePullPolicy: Always。

具体解决办法 #

1. 动态更新镜像标签并传递给 Helm #

每次构建新镜像时，使用唯一标签（比如和 Chart 版本一致的 ${env.BUILD_NUMBER}），并将该标签传入 Helm：

• 修改流水线中的 Helm 命令，添加镜像标签参数：

  sh "helm upgrade --install --namespace ${NAMESPACE} --values ${HELM_VALUES} --set image.tag=${env.BUILD_NUMBER} --version ${CHART_VERSION} ${RELEASE_NAME} ${CHART_NAME}"
  

• 确保 Chart 的 values.yaml 中 image.tag 为可配置变量，模板引用该值：

  # Chart 的 values.yaml
  image:
    repository: 你的ECR仓库地址
    tag: "latest" # 默认值，会被流水线的--set覆盖
    pullPolicy: Always
  

2. 给 Deployment 加可变注解触发更新 #

如果无法修改镜像标签（不推荐），可以在 Deployment 模板中添加随构建变化的注解，让 Kubernetes 检测到 Pod 模板变更：

• 在 Chart 的 Deployment 模板中添加：

  spec:
    template:
      metadata:
        annotations:
          build.number: "{{ .Values.buildNumber }}"
  

• 流水线中传递该注解的值：

  sh "helm upgrade --install --namespace ${NAMESPACE} --values ${HELM_VALUES} --set buildNumber=${env.BUILD_NUMBER} --version ${CHART_VERSION} ${RELEASE_NAME} ${CHART_NAME}"
  

3. 校验 Chart 版本的实际内容 #

你的 Chart 版本是 1.0.${env.BUILD_NUMBER}，但如果仅镜像变更时 Chart 内容未做修改，新生成的 Chart 包和旧版本内容完全一致。这种情况下 Helm 不会触发资源更新，因为渲染后的清单没有变化。要确保每次镜像更新时，Chart 中镜像相关配置（或上述可变注解）同步更新。

4. 强制滚动更新（应急方案） #

如果以上方法无法快速落地，可以用 --force 参数强制 Helm 重新部署，但这种方式可能导致服务中断，需谨慎使用：

sh "helm upgrade --install --force --namespace ${NAMESPACE} --values ${HELM_VALUES} --version ${CHART_VERSION} ${RELEASE_NAME} ${CHART_NAME}"

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