容器与云原生 / 系统课时
暂停与恢复滚动发布
暂停与恢复滚动发布
滚动发布进入验证期或出现异常时,不一定要立刻回退。Deployment 可以先暂停 rollout,阻止控制器继续推进新旧 ReplicaSet 的替换,同时保留已经发生的更新。关键是先执行暂停,再做现场检查;确认模板、容量和健康信号满足条件后再恢复。
学习目标
- 使用
kubectl rollout pause与kubectl rollout resume控制 Deployment 的发布推进 - 区分暂停 rollout 与冻结 Pod 生命周期,判断暂停期间仍可能发生的变化
- 按“先暂停、再验证、后恢复”的顺序操作,避免状态观察命令阻塞止损动作
暂停会停止什么
Deployment 在滚动更新时持续协调新旧 ReplicaSet 的副本数。执行 kubectl rollout pause 后,Deployment 的 rollout 不再继续推进;已经创建的 ReplicaSet、已经替换的 Pod 和当前副本状态不会因为暂停而自动回到发布前。
暂停因此适合“保留现场继续调查”,而不是“恢复旧版本”。暂停期间 ReplicaSet 仍会维持自己当前的期望副本数,Pod 也可能因为探针失败、节点故障、驱逐或人工删除而被重建,所以暂停并不等于冻结整个工作负载。

先暂停,再做现场检查
kubectl rollout status 默认会持续观察最新 rollout,直到发布完成或失败。如果 rollout 正在进行,把它放在 pause 前面顺序执行,命令可能长期占住当前终端,后续暂停就无法及时执行。需要先控制扩散时,应先暂停,再使用 get、describe 等命令读取当前状态;只想做一次状态查询时,可为 rollout status 使用 --watch=false。
下面把暂停、检查、暂停期间修正模板以及恢复合并为一个主流程。示例假设 Deployment 名为 web,Pod 标签为 app=web,容器名为 web。
# 先暂停,确保止损动作不会被状态观察阻塞
kubectl rollout pause deployment/web
kubectl get deployment web -o jsonpath='{.spec.paused}{"\n"}'
kubectl get rs -l app=web --sort-by=.metadata.creationTimestamp
kubectl get pods -l app=web
# 如已确认需要修正模板,可在暂停期间修改并再次核对
kubectl set image deployment/web web=registry.example.com/web:1.4.1
kubectl get deployment web -o jsonpath='{.spec.paused}{"\n"}{.spec.template.spec.containers[0].image}{"\n"}'
# 验证通过后恢复,并限制等待时间
kubectl rollout resume deployment/web
kubectl rollout status deployment/web --timeout=2m预期输出
deployment.apps/web paused
true
NAME DESIRED CURRENT READY AGE
web-<ID> <VALUE> <VALUE> <VALUE> <TIME>
web-<ID> <VALUE> <VALUE> <VALUE> <TIME>
NAME READY STATUS RESTARTS AGE
web-<ID>-<ID> <VALUE> Running <VALUE> <TIME>
deployment.apps/web image updated
true
registry.example.com/web:1.4.1
deployment.apps/web resumed
deployment "web" successfully rolled outReplicaSet、Pod 名称、副本数、重启次数和时间都取决于实际 rollout 阶段,因此示例用 <ID>、<VALUE> 和 <TIME> 表示动态值。若恢复后的 rollout status 在两分钟内没有完成,命令会超时退出,此时应继续排查,而不是反复执行 resume。
暂停期间修改模板
暂停后可以修改 .spec.template 中的镜像、环境变量等 Pod 模板字段。这些修改会写入 Deployment,但不会在暂停状态下触发新的 rollout 推进;恢复后,控制器会基于恢复时的最终模板继续协调 ReplicaSet。
因此,暂停期间可以合并多个经过审查的模板修正,避免每改一个字段就触发一次新的 rollout。恢复前必须再次确认最终镜像和配置确实是准备发布的版本,而不能只因为 .spec.paused=true 就认为现场已经安全。
恢复前后的门禁
恢复前至少确认三件事:Deployment 当前模板正确,现有 READY 与 AVAILABLE 容量足以承载业务,已经上线的新版本实例没有持续出现错误率、延迟、探针或日志异常。只有这些信号都允许继续发布,才执行 kubectl rollout resume。
恢复后再用 kubectl rollout status 等待 rollout 完成是合理的,因为此时“等待发布结束”就是操作目标。若出现镜像拉取失败、调度失败、探针失败或可用副本不足,应结合 Pod 事件和 maxUnavailable、maxSurge 等滚动更新约束定位根因,而不是把暂停与恢复命令当成修复手段。