CI/CD / 系统课时
验证发布与执行回滚
验证发布与执行回滚
Kubernetes 显示“已提交变更”并不等于发布成功。本节用工作负载状态、Pod 与事件、应用健康接口三层证据确认新版本可用,并在异常时用 Deployment 修订记录恢复上一稳定版本,形成可重复的发布验收与回滚路径。
学习目标
- 能用
kubectl rollout、Deployment 与 Pod 状态判断滚动发布是否完成。 - 能结合事件和应用健康接口区分“调度成功”与“业务可用”。
- 能在发布异常时回滚到上一修订,并验证服务重新稳定。
先确认滚动发布完成
验证应先看 Deployment 的发布控制面,而不是只挑一个 Pod 查看。下面假设工作负载名为 checkout-api、命名空间为 production;实际名称不同时替换变量值。
NS=production
APP=checkout-api
kubectl rollout status deployment/$APP -n $NS --timeout=120s
kubectl get deployment/$APP -n $NS
kubectl get pods -n $NS -l app=$APP预期输出
deployment "checkout-api" successfully rolled out
NAME READY UP-TO-DATE AVAILABLE AGE
checkout-api 3/3 3 3 <TIME>
NAME READY STATUS RESTARTS AGE
checkout-api-<ID> 1/1 Running 0 <TIME>
checkout-api-<ID> 1/1 Running 0 <TIME>
checkout-api-<ID> 1/1 Running 0 <TIME>READY、UP-TO-DATE 和 AVAILABLE 应达到期望副本数,Pod 也应保持 Running 且无持续重启。<ID>、<TIME> 等值由集群动态生成,实际输出会不同。
再检查事件与应用接口
控制器成功只能证明 Kubernetes 已把新 Pod 拉起,不能证明依赖连接、配置加载和业务接口都正常。先查看最近事件,再从发布环境访问应用健康接口。
NS=production
APP=checkout-api
HEALTH_URL="https://<HOST>/healthz"
kubectl get events -n $NS --sort-by=.lastTimestamp | tail -n 20
curl -fsS "$HEALTH_URL"预期输出
<LAST_SEEN> Normal ScalingReplicaSet deployment/checkout-api Scaled up replica set <ID>
<LAST_SEEN> Normal Available deployment/checkout-api Deployment has minimum availability.
{"status":"ok"}事件里若持续出现 FailedScheduling、FailedMount、ImagePullBackOff 或探针失败,应先处理基础故障;健康接口还应覆盖应用真正依赖的关键资源,而不是只返回进程存活。

异常时回滚到稳定修订
Deployment 会为 Pod 模板变更保留修订历史。确认当前发布确实引入故障后,先查看历史,再默认回到上一修订;如果团队已经明确稳定修订号,可使用 --to-revision=<ID> 精确回滚。
NS=production
APP=checkout-api
kubectl rollout history deployment/$APP -n $NS
kubectl rollout undo deployment/$APP -n $NS
kubectl rollout status deployment/$APP -n $NS --timeout=120s预期输出
deployment.apps/checkout-api
REVISION CHANGE-CAUSE
<ID> <VALUE>
<ID> <VALUE>
deployment.apps/checkout-api rolled back
deployment "checkout-api" successfully rolled out回滚完成后必须再次检查副本、事件、健康接口和核心业务指标,不能把 rolled back 当成最终成功信号。若失败来自独立的 ConfigMap、Secret、数据库变更或外部服务,Deployment 回滚不会自动恢复这些对象,需要按对应变更记录单独处理。
把回滚变成发布门禁
稳定的 CI/CD 流程应把验证条件写成门禁:滚动发布超时、可用副本不足、错误率上升或健康检查失败时立即停止扩散,并保留镜像版本、Deployment 修订号和变更记录。回滚不是“重新发布一个猜测版本”,而是恢复到已验证的稳定状态,再用同一套检查确认故障真正消失。