CI/CD / 系统课时
用 Git revert 做版本回退
用 Git revert 做版本回退
GitOps 的回退重点不是把集群手工改回旧状态,而是让 Git 中的期望状态也回到可工作的版本。git revert 会创建一个新的反向提交,保留故障发布及回退记录,使 Argo CD 能沿正常同步链路恢复应用。
学习目标
- 理解
git revert在 GitOps 回滚中的作用 - 完成从定位提交、创建 revert 到推送和同步验证的回退流程
- 区分 Git 回退与直接执行
kubectl修改集群的后果
为什么回退 Git 而不是只改集群
假设提交 A 将镜像从 1.4.2 升级到 1.5.0,随后发现新版本存在故障。如果直接用 kubectl set image 把 Deployment 改回 1.4.2,集群状态已经偏离 Git;下一次 Argo CD 自动同步还可能再次应用 Git 中的 1.5.0。
GitOps 更稳定的处理方式是创建一个撤销提交 A 的新提交 B。Git 历史同时留下“发布过什么”和“为什么回退”的证据,Argo CD 再把 B 表示的期望状态同步到集群。

创建反向提交
先确认最近提交,找到引入故障配置的提交哈希:
git log --oneline -5预期输出
<ID> deploy web 1.5.0
<ID> deploy web 1.4.2
<ID> update ingress annotations<ID> 是动态提交哈希,实际值不同。确认目标后执行 revert;以下命令中的 <ID> 应替换为需要撤销的真实提交哈希:
git revert <ID>预期输出
[main <ID>] Revert "deploy web 1.5.0"
1 file changed, 1 insertion(+), 1 deletion(-)文件数量和增删行数取决于原提交。git revert 不会删除原提交,而是生成一个语义相反的新提交,因此比重写共享分支历史更适合已经进入 GitOps 发布链路的变更。
推送后让 Argo CD收敛
检查 revert 的差异无误后推送当前分支:
git show --stat --oneline HEAD
git push origin main预期输出
<ID> Revert "deploy web 1.5.0"
<PATH> | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
To <PATH>
<ID>..<ID> main -> main<PATH> 和 <ID> 是动态值。启用自动同步时,Argo CD 检测到新提交后会按配置自动收敛;未启用自动同步时,需要通过组织允许的 Argo CD 同步流程执行同步。
验证回退结果
回退不能以 git push 成功为终点。需要确认 Git 中的目标值、Argo CD 期望状态和 Kubernetes 实际工作负载最终一致。以 Deployment 为例:
kubectl rollout status deployment/web -n demo --timeout=120s
kubectl get deployment web -n demo -o jsonpath='{.spec.template.spec.containers[*].image}'预期输出
deployment "web" successfully rolled out
registry.example.com/web:1.4.2如果 Git 已回退但集群迟迟没有变化,应检查 Argo CD 是否检测到新 revision、应用是否开启自动同步、同步是否失败,以及 Application 是否确实跟踪了刚才推送的分支和路径。
直接改集群为什么不等于 GitOps 回滚
紧急情况下,人工修改集群可能暂时恢复业务,但它只改变 live state,没有修复 Git 中的 desired state。对于开启自动同步和 self-heal 的应用,手工改动还可能很快被 Argo CD 恢复为 Git 中的值。
git revert 的价值不仅是恢复旧配置,更是把回退本身变成新的、可审计的期望状态变更。这样发布、故障和恢复都留在同一条 Git 历史与 Argo CD 同步链路中。