容器与云原生 / 系统课时

理解版本历史与 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 的过程。

Deployment 修订历史与 rollout undo 关系

查询并执行指定修订回退

生产环境不应直接把“上一修订”当成稳定版本。更可靠的做法是先查看历史,再检查目标 revision 的 Pod 模板,确认镜像等内容正确后显式回退,并等待 rollout 完成。

bash
# 查看可用修订
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

预期输出

text
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 与业务健康,并验证外部状态仍与回退后的应用版本兼容。

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

目录与阅读设置

阅读设置

17

记录一个想法

理解版本历史与 rollout undo

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

登录哪都通