CI/CD / 系统课时

通过 Git 回滚发布

通过 Git 回滚发布

GitOps 回滚的核心不是直接改线上资源,而是把 Git 中的期望状态恢复到已知可用版本,再让同步控制器完成部署。本节用 git revert 保留完整审计链,并给出回滚后必须完成的同步与运行状态验证。

学习目标

  • 能从提交历史中定位需要撤销的发布变更,并区分 revert 与重写历史。
  • 能创建并推送可审计的回滚提交,触发 GitOps 自动同步。
  • 能验证 Kubernetes 工作负载已经回到预期镜像,并识别不适合只靠 Git 回滚的情况。

先确认要撤销的发布提交

共享的 GitOps 主分支通常不应使用 git reset --hard 后强推,因为那会改写公共历史。更安全的做法是找到导致故障的提交,用一个新的反向提交撤销它;这样“发布了什么、为何回滚、谁执行了回滚”都能留在 Git 历史中。

先同步主分支并查看最近提交。把输出中的实际提交号代入后续命令。

bash
git switch main
git pull --ff-only
git log --oneline -5

预期输出

text
<BAD_COMMIT_ID> change production image to v2.4.0
<PREVIOUS_COMMIT_ID> change production image to v2.3.7
<ID> <COMMIT_MESSAGE>

<ID> 与提交信息会随仓库实际历史变化,切换分支和拉取时的提示也可能不同。回滚前还要确认该提交只包含准备撤销的配置;如果一个提交混入了无关改动,应先拆解影响范围,而不是机械撤销。

GitOps 通过 Git 回滚发布的审计链路

这条链路的关键是:集群状态由 Git 重新驱动,而不是由人工命令长期覆盖。临时手改线上对象即使能止血,也会造成 Git 与运行环境漂移,并可能在下一次同步时被控制器再次覆盖。

用 revert 生成回滚提交

假设 <BAD_COMMIT_ID> 就是需要完整撤销的发布提交,可以在最新的 main 上创建反向提交。--no-edit 会沿用 Git 自动生成的回滚说明,便于标准化审计。

bash
git revert --no-edit <BAD_COMMIT_ID>
git show --no-patch --oneline HEAD

预期输出

text
<ROLLBACK_COMMIT_ID> Revert "change production image to v2.4.0"

确认本地回滚提交正确后再推送远端。若仓库启用了受保护分支,应按团队规则通过回滚 PR 合并,而不是绕过保护策略。

bash
git push origin main

预期输出

text
To <GIT_REMOTE>
   <OLD_HEAD_ID>..<ROLLBACK_COMMIT_ID>  main -> main

<GIT_REMOTE> 和提交号会因仓库而不同。推送成功只代表 Git 已记录期望状态,不能等价为生产环境已经恢复。

等待自动同步并验证运行状态

GitOps 控制器检测到新提交后,会把仓库中的旧版本期望状态重新应用到目标环境。若目标环境是 Kubernetes,可从工作负载就绪状态和实际镜像两侧验证,避免只看“同步成功”就结束回滚。

bash
kubectl -n <NAMESPACE> rollout status deployment/<DEPLOYMENT> --timeout=120s
kubectl -n <NAMESPACE> get deployment <DEPLOYMENT> -o jsonpath='{.spec.template.spec.containers[0].image}{"\n"}'

预期输出

text
deployment "<DEPLOYMENT>" successfully rolled out
<EXPECTED_IMAGE>

<NAMESPACE>、<DEPLOYMENT> 与 <EXPECTED_IMAGE> 替换为实际值。若 Git 已回滚但集群迟迟不同步,应继续检查控制器是否能读取仓库、渲染清单是否失败、目标集群是否可达,而不是再次手工修改 Deployment。

什么时候不能只靠 Git revert

Git 只能可靠恢复由 Git 管理且具备可逆语义的声明状态。数据库不可逆迁移、一次性数据修复、外部系统配置、已经轮换的密钥或产生副作用的任务,可能不会随着配置回退自动恢复。

遇到这类发布,应把“应用版本回退”和“状态恢复”拆开设计:先判断数据与外部依赖是否向后兼容,再执行专门的恢复脚本或前向修复。可审计的 Git 回滚仍然是控制面的入口,但最终验收必须以业务可用性、运行状态和关键数据都恢复到安全范围为准。

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

目录与阅读设置

阅读设置

17

记录一个想法

通过 Git 回滚发布

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

登录哪都通