容器与云原生 / 系统课时
滚动更新与版本回退
滚动更新与版本回退
本课通过一个可执行的 Deployment 示例,配置滚动更新节奏、观察新旧 ReplicaSet 的替换过程,并在新版本异常时按历史修订回退,最终形成一套可验证、可恢复的发布流程。
学习目标
- 理解
maxSurge、maxUnavailable如何共同控制更新速度与可用性 - 使用
kubectl rollout查看发布状态、历史修订并执行回退 - 通过镜像版本、Pod 状态和历史记录验证发布结果
配置滚动更新策略
Deployment 更新 Pod 模板后,不会直接修改原有 Pod,而是创建新的 ReplicaSet,再逐步扩大新副本、缩小旧副本。下面配置 4 个副本,并允许更新期间最多额外创建 1 个 Pod、最多有 1 个期望副本暂时不可用。
apiVersion: apps/v1
kind: Deployment
metadata:
name: web
annotations:
kubernetes.io/change-cause: "initial release nginx 1.25"
spec:
replicas: 4
strategy:
type: RollingUpdate
rollingUpdate:
maxSurge: 1
maxUnavailable: 1
selector:
matchLabels:
app: web
template:
metadata:
labels:
app: web
spec:
containers:
- name: nginx
image: nginx:1.25-alpine
ports:
- containerPort: 80
readinessProbe:
httpGet:
path: /
port: 80
periodSeconds: 3
failureThreshold: 3该配置生效后,更新期间 Pod 总数最多为 5,至少应保持 3 个可用副本。Readiness Probe 未通过的新 Pod 不会被计入可用副本,因此能阻止控制器过早删除旧 Pod。

执行一次滚动发布
将清单保存为 web-deployment.yaml,先创建初始版本,再把变更原因写入 Deployment 后更新镜像。先记录原因、后修改 Pod 模板,可以让新 ReplicaSet 保存正确的发布说明。
kubectl apply -f web-deployment.yaml
kubectl rollout status deployment/web
kubectl annotate deployment/web kubernetes.io/change-cause="upgrade to nginx 1.26" --overwrite
kubectl set image deployment/web nginx=nginx:1.26-alpine
kubectl rollout status deployment/web
kubectl rollout history deployment/web预期输出的关键部分如下,修订号和等待时长可能因集群现状不同而变化。
deployment.apps/web created
deployment "web" successfully rolled out
deployment.apps/web annotated
deployment.apps/web image updated
deployment "web" successfully rolled out
deployment.apps/web
REVISION CHANGE-CAUSE
1 initial release nginx 1.25
2 upgrade to nginx 1.26kubectl rollout status 会持续等待,直到新副本达到期望数量且旧副本完成缩容。若镜像无法拉取或 Readiness 一直失败,命令会保持等待,此时应先查看 Pod 事件,而不是继续叠加新版本。
在异常时回退版本
确认新版本异常后,可以回退到指定修订。回退本身仍由 Deployment 以滚动方式完成,不会直接恢复已经删除的 Pod,而是重新使用目标修订中的 Pod 模板创建新副本。
kubectl rollout undo deployment/web --to-revision=1
kubectl rollout status deployment/web
kubectl get deployment web -o jsonpath='{.spec.template.spec.containers[0].image}'; echo预期输出如下。
deployment.apps/web rolled back
deployment "web" successfully rolled out
nginx:1.25-alpine回退后还应执行 kubectl get pods -l app=web,确认所有 Pod 为 Running 且 READY 列达到 1/1。如果历史中看不到需要的修订,通常是旧 ReplicaSet 已被 revisionHistoryLimit 清理,不能再依赖 rollout undo 恢复。
发布失败的定位顺序
先运行 kubectl rollout status deployment/web 判断发布是否完成,再用 kubectl get pods -l app=web 找到异常 Pod,最后通过 kubectl describe pod <POD_NAME> 查看镜像拉取、探针和调度事件。只有确认根因后,才决定继续修复当前版本还是立即回退。
常见错误包括把 maxUnavailable 设得过大导致容量骤降、没有 Readiness Probe 就过早接收流量,以及复用浮动镜像标签导致修订内容难以追溯。生产发布应使用不可变镜像标签或镜像摘要,并在变更前记录发布原因。