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。三者相关,但没有任何规则要求它们的版本号相同。

Chart、镜像与Git revision的版本追踪关系

在 Git 中固定可部署版本

生产环境应避免依赖 latest 这类可变标签。更稳妥的做法是在 Git 中显式记录镜像 tag;要求更强的不可变性时,可以记录镜像 digest。

片段示例,假设 Chart 已使用 .Values.image.repository 和 .Values.image.tag 生成容器镜像:

yaml
image:
  repository: registry.example.com/api
  tag: "1.18.3"
  pullPolicy: IfNotPresent

这段配置生效后,渲染出的工作负载应引用 registry.example.com/api:1.18.3。可在 Chart 目录执行渲染验证:

bash
helm template api . --set image.repository=registry.example.com/api --set image.tag=1.18.3 | grep 'image:'

预期输出

text
image: "registry.example.com/api:1.18.3"

引号是否出现在渲染结果中取决于模板写法,但仓库和 tag 应一致。

从 Git 追到集群实际镜像

发生“Git 已升级但线上还是旧版本”时,不要只检查 Chart.yaml。先确认 Argo CD 当前同步到哪个 revision,再读取 Deployment 声明的镜像。

bash
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 版本和应用状态而变化。第二条命令在本例应得到:

text
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 镜像”的方向逐层核对,比尝试让三个版本号保持一致更可靠。版本号负责表达各自对象的演进,真正的可追溯性来自它们之间明确、可验证的映射关系。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

处理 Helm Chart 与镜像版本漂移

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通