容器与云原生 / 系统课时
理解版本历史与 rollout undo
理解版本历史与 rollout undo
Deployment 的回退依赖历史 ReplicaSet,而不是完整集群快照。kubectl rollout history 用于确认可回退的修订,kubectl rollout undo 则把 Pod 模板恢复到历史版本;数据库、ConfigMap 等独立状态不会随之自动回滚。
学习目标
- 理解 Deployment revision 与历史 ReplicaSet 的关系
- 使用
kubectl rollout history查询修订并执行指定版本回退 - 区分 Deployment 能恢复的 Pod 模板与必须单独处理的外部状态
Deployment 历史保存了什么
当 Deployment 的 .spec.template 发生变化并触发新的 rollout 时,控制器会为新的 Pod 模板维护 ReplicaSet 和修订编号。kubectl rollout history 展示的 revision 对应仍被保留、可用于查看或回退的历史版本;单纯调整副本数不会因为 Pod 模板未变化而形成新的模板修订。
回退并不是直接把旧 Pod 原样恢复,而是把历史 Pod 模板重新应用到 Deployment,再由控制器按照滚动更新策略调整 ReplicaSet。因此,undo 仍会经历创建或扩容目标 ReplicaSet、缩容当前 ReplicaSet以及等待新 Pod Ready 的过程。

查询并执行指定修订回退
生产环境不应直接把“上一修订”当成稳定版本。更可靠的做法是先查看历史,再检查目标 revision 的 Pod 模板,确认镜像等内容正确后显式回退,并等待 rollout 完成。
# 查看可用修订
kubectl rollout history deployment/web
# 检查 revision 2 保存的 Pod 模板
kubectl rollout history deployment/web --revision=2
# 明确回退到已确认的修订,并等待滚动发布结束
kubectl rollout undo deployment/web --to-revision=2
kubectl rollout status deployment/web
# 验证当前模板、历史保留上限和 Pod 状态
kubectl get deployment web -o jsonpath='{.spec.template.spec.containers[0].image}' && echo
kubectl get deployment web -o jsonpath='{.spec.revisionHistoryLimit}' && echo
kubectl get pods -l app=web预期输出
deployment.apps/web
REVISION CHANGE-CAUSE
1 <none>
2 <none>
3 <none>
deployment.apps/web with revision #2
Pod Template:
Labels: <VALUE>
Containers:
web:
Image: <VALUE>
deployment.apps/web rolled back
deployment "web" successfully rolled out
<VALUE>
10
NAME READY STATUS RESTARTS AGE
web-<ID> 1/1 Running <VALUE> <TIME>revision 数量、模板字段、镜像、Pod 名称和运行时间都取决于实际集群。如果未记录变更原因,CHANGE-CAUSE 常见为 <none>。命令返回 rolled back 只表示回退请求已被接受,真正完成还要以 rollout status、Pod Ready 和业务健康检查为准。
如果只是希望回到上一可用修订,也可以执行 kubectl rollout undo deployment/web。但连续发布过多个版本时,上一修订未必是最后一个稳定版本,所以故障处置通常更适合先确认 revision,再使用 --to-revision。
undo 能恢复哪些内容
rollout undo 恢复的是历史修订中的 Pod 模板,也就是 .spec.template 下的内容,例如容器镜像、环境变量、启动命令、资源请求与限制、探针和模板标签。恢复这些字段后,Deployment 会按照当前滚动更新策略重新部署它们。
它不是通用的系统回滚机制。独立修改的 ConfigMap、Secret、Service、Ingress、NetworkPolicy 不会自动恢复;数据库 schema、数据迁移、消息格式以及已经写入外部系统的副作用也不会被撤销。
历史保留决定回退窗口
Deployment 通过 .spec.revisionHistoryLimit 控制保留多少个旧 ReplicaSet,未显式设置时默认值为 10。超过保留范围并被控制器清理的历史 ReplicaSet,不能再作为 rollout undo 的目标,因此 Deployment revision 只适合短期快速回退,不能替代 Git、镜像仓库或数据库迁移记录。
把该值设得过小会缩短可直接回退的窗口;设得更大可以保留更多旧 ReplicaSet 元数据,但不会保存 Deployment 之外的配置和业务数据。真正可靠的恢复结果,应同时确认目标 Pod 模板已经生效、Pod 与业务健康,并验证外部状态仍与回退后的应用版本兼容。