CI/CD / 系统课时
处理 Helm Chart 与镜像版本漂移
处理 Helm Chart 与镜像版本漂移
一次 GitOps 发布至少同时涉及 Chart 版本、应用镜像版本和 Git revision。只记录其中一个,出现回滚或环境差异时就很难回答“集群究竟运行哪份代码”。本节建立三层版本映射,并用 Argo CD 与 Helm 命令验证实际状态。
学习目标
- 区分 Chart 版本、应用镜像版本与 Git revision 的职责
- 建立从 Git 提交到 Chart 和镜像的可追溯关系
- 定位 Git 声明与集群实际镜像不一致的版本漂移
三种版本不要混成一个
Helm Chart 的 version 描述 Chart 包自身版本,appVersion 是应用版本信息;真正决定 Pod 使用哪个镜像的通常是 values 中传入模板的 image.tag 或 digest。Git revision 则标识产生声明配置的 Git 提交、分支或标签。
例如 Git revision 为 8f31c2a,其中保存 Chart 2.4.1,并声明镜像 registry.example.com/api:1.18.3。三者相关,但没有任何规则要求它们的版本号相同。

在 Git 中固定可部署版本
生产环境应避免依赖 latest 这类可变标签。更稳妥的做法是在 Git 中显式记录镜像 tag;要求更强的不可变性时,可以记录镜像 digest。
片段示例,假设 Chart 已使用 .Values.image.repository 和 .Values.image.tag 生成容器镜像:
image:
repository: registry.example.com/api
tag: "1.18.3"
pullPolicy: IfNotPresent这段配置生效后,渲染出的工作负载应引用 registry.example.com/api:1.18.3。可在 Chart 目录执行渲染验证:
helm template api . --set image.repository=registry.example.com/api --set image.tag=1.18.3 | grep 'image:'预期输出
image: "registry.example.com/api:1.18.3"引号是否出现在渲染结果中取决于模板写法,但仓库和 tag 应一致。
从 Git 追到集群实际镜像
发生“Git 已升级但线上还是旧版本”时,不要只检查 Chart.yaml。先确认 Argo CD 当前同步到哪个 revision,再读取 Deployment 声明的镜像。
argocd app get api
kubectl get deployment api -n production -o jsonpath='{.spec.template.spec.containers[*].image}'
printf '\n'预期结果中,argocd app get 应显示应用的同步状态与对应 revision;具体文本布局随 Argo CD 版本和应用状态而变化。第二条命令在本例应得到:
registry.example.com/api:1.18.3如果 Git revision 正确,但 Deployment 仍引用旧镜像,应继续检查 Argo CD 是否已经完成同步、values 来源是否正确,以及参数覆盖是否改变了 image.tag。
给一次发布留下完整证据
可追溯发布至少应能关联 Git revision、Chart version 和镜像的不可变标识。镜像 tag 容易阅读,但仓库允许覆盖同名 tag 时,仅靠 tag 不能证明镜像内容未变化;关键环境可进一步记录 digest。
出现版本漂移时,沿“Git revision → Chart 与 values → Argo CD 渲染结果 → Deployment → Pod 镜像”的方向逐层核对,比尝试让三个版本号保持一致更可靠。版本号负责表达各自对象的演进,真正的可追溯性来自它们之间明确、可验证的映射关系。