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 revert驱动Argo CD回退的状态流

创建反向提交

先确认最近提交,找到引入故障配置的提交哈希:

bash
git log --oneline -5

预期输出

text
<ID> deploy web 1.5.0
<ID> deploy web 1.4.2
<ID> update ingress annotations

<ID> 是动态提交哈希,实际值不同。确认目标后执行 revert;以下命令中的 <ID> 应替换为需要撤销的真实提交哈希:

bash
git revert <ID>

预期输出

text
[main <ID>] Revert "deploy web 1.5.0"
 1 file changed, 1 insertion(+), 1 deletion(-)

文件数量和增删行数取决于原提交。git revert 不会删除原提交,而是生成一个语义相反的新提交,因此比重写共享分支历史更适合已经进入 GitOps 发布链路的变更。

推送后让 Argo CD收敛

检查 revert 的差异无误后推送当前分支:

bash
git show --stat --oneline HEAD
git push origin main

预期输出

text
<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 为例:

bash
kubectl rollout status deployment/web -n demo --timeout=120s
kubectl get deployment web -n demo -o jsonpath='{.spec.template.spec.containers[*].image}'

预期输出

text
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 同步链路中。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 Git revert 做版本回退

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

登录哪都通