CI/CD / 系统课时
检查一次提交会改变什么
检查一次提交会改变什么
GitOps 中一次看似很小的 Values 修改,最终可能改变 Deployment、Service 等多个 Kubernetes 对象。提交前应从 Git diff、Helm render 和 Argo CD diff 三层逐步检查,把“改了哪个文件”追踪到“集群最终会改变什么”。
学习目标
- 区分 Git diff、Helm render 与 Argo CD diff 各自检查的范围
- 在提交前渲染 Helm 模板并核对实际 Kubernetes 清单
- 使用 Argo CD diff 判断期望状态与目标集群状态的差异
三层检查解决不同问题
git diff 回答的是“源码改了什么”,适合发现镜像标签、资源限制或环境 Values 是否被误改。它无法直接告诉你模板渲染后哪些 Kubernetes 字段会变化。
helm template 回答的是“这些 Chart 和 Values 最终渲染成什么”。这一层能够发现条件模板、默认值和 Values 覆盖带来的间接变化,但它仍然不是目标集群当前状态。
argocd app diff 则从 Argo CD Application 的视角比较目标期望状态与集群状态。三层组合后,检查路径才从 Git 文件一直延伸到待同步资源。

先检查 Git 中的直接修改
假设环境仓库中通过 values-prod.yaml 固定生产镜像版本。修改完成后,不要立即提交,先查看工作区差异:
git diff -- values-prod.yaml预期输出
diff --git a/values-prod.yaml b/values-prod.yaml
index <ID>..<ID> 100644
--- a/values-prod.yaml
+++ b/values-prod.yaml
@@ <ID>,<ID> <ID>,<ID> @@
image:
- tag: "1.4.2"
+ tag: "1.4.3"<ID> 表示 Git 根据实际文件内容生成的动态值。这里首先确认修改范围只有预期的镜像标签;如果同时出现副本数、资源限制或其他环境配置变化,应在进入下一层前查明原因。
再检查 Helm 渲染结果
Git diff 只能看到 Values 文件变化。下一步使用与目标环境相同的 Chart 和 Values 渲染清单:
helm template myapp ./charts/myapp -f values-prod.yaml > /tmp/myapp-rendered.yaml
helm lint ./charts/myapp -f values-prod.yaml预期输出
==> Linting ./charts/myapp
<RESULT><RESULT> 的具体文本可能随 Helm 版本和 Chart 内容不同;关键验证条件是 helm lint 成功退出,并且 /tmp/myapp-rendered.yaml 成功生成。随后检查渲染文件中的 Deployment 镜像,确认标签确实变成目标版本,而不是只确认 Values 文件写对了。
最后检查 Argo CD 看到的差异
当提交已经存在于 Argo CD Application 跟踪的 Git revision 中,但尚未同步时,可以通过 CLI 查看应用差异:
argocd app diff myapp预期结果
<DIFF><DIFF> 取决于应用当前 Live 状态与 Git 中 Target 状态,因此不能预先固定。检查时关注资源名称、字段路径以及删除或新增方向,确认变化只落在计划范围内;命令返回非零状态也可能表示检测到了差异,应结合实际 diff 内容判断,而不能只把退出码当成命令失败。
把检查顺序固定下来
实际发布前可以固定采用“Git → Render → Argo CD”的顺序。第一层控制人为编辑范围,第二层验证模板展开后的真实资源,第三层确认这些期望状态相对集群会造成什么变化。
如果 Git diff 只有一行,而 Helm 或 Argo CD diff 出现大量资源变化,不应因为源码改动很小就继续同步。应先检查 Values 覆盖顺序、Chart 版本、条件模板、Application revision 和目标环境是否一致,直到能够解释每一项待变更资源。