容器与云原生 / 系统课时

版本回滚与发布暂停

版本回滚与发布暂停

Deployment 发布失败时,关键不是“重新发一次”,而是先确认当前修订、控制继续扩散的变更,再恢复到已验证版本。本节用一组可执行命令完成历史查看、暂停、继续与指定修订回滚,并说明这些动作各自影响什么。

学习目标

  • 使用 kubectl rollout history 查看 Deployment 修订历史并识别可回滚版本。
  • 使用 kubectl rollout pause 与 kubectl rollout resume 控制新 Pod 模板变更的发布时机。
  • 使用 kubectl rollout undo 回滚并验证实际运行镜像。

发布历史为什么能回滚

Deployment 每次成功处理新的 Pod 模板都会形成新的修订,并由对应 ReplicaSet 保存模板。回滚并不是把集群“倒回过去”,而是把某个历史模板重新设为期望状态,再由 Deployment 控制器执行一次新的滚动发布。

Deployment 发布暂停、继续与回滚关系

先创建一个示例 Deployment,再发布第二个镜像版本。为避免观察到中间状态,两个版本都等待滚动完成后再查看历史。

bash
# 创建首个稳定版本并等待就绪
kubectl create deployment demo-web --image=nginx:1.24-alpine
kubectl rollout status deployment/demo-web

# 修改 Pod 模板,形成第二个修订
kubectl set image deployment/demo-web nginx=nginx:1.25-alpine
kubectl rollout status deployment/demo-web
kubectl rollout history deployment/demo-web

预期输出

text
deployment.apps/demo-web created
deployment "demo-web" successfully rolled out
deployment.apps/demo-web image updated
deployment "demo-web" successfully rolled out
deployment.apps/demo-web
REVISION  CHANGE-CAUSE
1         <none>
2         <none>

CHANGE-CAUSE 是否为空不影响回滚;真正关键的是修订号仍在 Deployment 的历史保留范围内。

暂停后合并模板变更

暂停适合“先冻结发布,再集中修改多个模板字段”的场景。pause 不会停止已经运行的 Pod,也不会冻结业务流量;它只是让 Deployment 控制器暂不推进新的滚动发布。

bash
# 暂停后修改镜像,期望状态会变化,但控制器暂不推进新修订
kubectl rollout pause deployment/demo-web
kubectl set image deployment/demo-web nginx=nginx:1.26-alpine
kubectl get deployment demo-web -o jsonpath='{.spec.paused}'
echo
kubectl get deployment demo-web -o jsonpath='{.spec.template.spec.containers[0].image}'
echo

预期输出

text
deployment.apps/demo-web paused
deployment.apps/demo-web image updated
true
nginx:1.26-alpine

确认修改无误后再继续发布:

bash
# 恢复控制器处理,暂停期间的模板修改会作为一次发布继续推进
kubectl rollout resume deployment/demo-web
kubectl rollout status deployment/demo-web

预期输出

text
deployment.apps/demo-web resumed
deployment "demo-web" successfully rolled out

回滚到稳定修订

假设 revision 1 是已验证的稳定版本,可以指定修订号回滚。回滚完成后再次读取 Pod 模板中的镜像,确认期望状态已经恢复。

bash
# 将历史模板重新设为当前期望状态,并等待新的滚动发布完成
kubectl rollout undo deployment/demo-web --to-revision=1
kubectl rollout status deployment/demo-web
kubectl get deployment demo-web -o jsonpath='{.spec.template.spec.containers[0].image}'
echo

预期输出

text
deployment.apps/demo-web rolled back
deployment "demo-web" successfully rolled out
nginx:1.24-alpine

回滚后修订历史不会简单“退回到 1”,而是会产生新的发布修订。生产环境应同时验证 Pod 就绪、业务探针和关键请求是否恢复,而不是只看 undo 命令返回成功。

操作边界

修订历史受 revisionHistoryLimit 影响,太旧的 ReplicaSet 可能已被清理;undo 也只恢复 Pod 模板,不会自动回滚数据库、ConfigMap 外部内容或镜像中依赖的状态。发布前把数据库变更、配置兼容性和应用回滚能力一起纳入检查,才能让 Deployment 回滚真正可用。

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

目录与阅读设置

阅读设置

17

记录一个想法

版本回滚与发布暂停

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

登录哪都通