容器与云原生 / 系统课时
版本回滚与发布暂停
版本回滚与发布暂停
Deployment 发布失败时,关键不是“重新发一次”,而是先确认当前修订、控制继续扩散的变更,再恢复到已验证版本。本节用一组可执行命令完成历史查看、暂停、继续与指定修订回滚,并说明这些动作各自影响什么。
学习目标
- 使用
kubectl rollout history查看 Deployment 修订历史并识别可回滚版本。 - 使用
kubectl rollout pause与kubectl rollout resume控制新 Pod 模板变更的发布时机。 - 使用
kubectl rollout undo回滚并验证实际运行镜像。
发布历史为什么能回滚
Deployment 每次成功处理新的 Pod 模板都会形成新的修订,并由对应 ReplicaSet 保存模板。回滚并不是把集群“倒回过去”,而是把某个历史模板重新设为期望状态,再由 Deployment 控制器执行一次新的滚动发布。

先创建一个示例 Deployment,再发布第二个镜像版本。为避免观察到中间状态,两个版本都等待滚动完成后再查看历史。
# 创建首个稳定版本并等待就绪
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预期输出
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 控制器暂不推进新的滚动发布。
# 暂停后修改镜像,期望状态会变化,但控制器暂不推进新修订
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预期输出
deployment.apps/demo-web paused
deployment.apps/demo-web image updated
true
nginx:1.26-alpine确认修改无误后再继续发布:
# 恢复控制器处理,暂停期间的模板修改会作为一次发布继续推进
kubectl rollout resume deployment/demo-web
kubectl rollout status deployment/demo-web预期输出
deployment.apps/demo-web resumed
deployment "demo-web" successfully rolled out回滚到稳定修订
假设 revision 1 是已验证的稳定版本,可以指定修订号回滚。回滚完成后再次读取 Pod 模板中的镜像,确认期望状态已经恢复。
# 将历史模板重新设为当前期望状态,并等待新的滚动发布完成
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预期输出
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 回滚真正可用。