CI/CD / 系统课时

验证发布与执行回滚

验证发布与执行回滚

Kubernetes 显示“已提交变更”并不等于发布成功。本节用工作负载状态、Pod 与事件、应用健康接口三层证据确认新版本可用,并在异常时用 Deployment 修订记录恢复上一稳定版本,形成可重复的发布验收与回滚路径。

学习目标

  • 能用 kubectl rollout、Deployment 与 Pod 状态判断滚动发布是否完成。
  • 能结合事件和应用健康接口区分“调度成功”与“业务可用”。
  • 能在发布异常时回滚到上一修订,并验证服务重新稳定。

先确认滚动发布完成

验证应先看 Deployment 的发布控制面,而不是只挑一个 Pod 查看。下面假设工作负载名为 checkout-api、命名空间为 production;实际名称不同时替换变量值。

bash
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

预期输出

text
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 拉起,不能证明依赖连接、配置加载和业务接口都正常。先查看最近事件,再从发布环境访问应用健康接口。

bash
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"

预期输出

text
<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 或探针失败,应先处理基础故障;健康接口还应覆盖应用真正依赖的关键资源,而不是只返回进程存活。

Kubernetes 发布验证与回滚门禁流程

异常时回滚到稳定修订

Deployment 会为 Pod 模板变更保留修订历史。确认当前发布确实引入故障后,先查看历史,再默认回到上一修订;如果团队已经明确稳定修订号,可使用 --to-revision=<ID> 精确回滚。

bash
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

预期输出

text
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 修订号和变更记录。回滚不是“重新发布一个猜测版本”,而是恢复到已验证的稳定状态,再用同一套检查确认故障真正消失。

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

目录与阅读设置

阅读设置

17

记录一个想法

验证发布与执行回滚

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

登录哪都通