滚动更新与回滚
🎯 引言
之前,我们通过 Deployment 运行了两个订单 Pod。现在订单接口要发布新版本:把 /api/info 返回的版本从 v1 改成 v2。
如果先删除两个旧 Pod,再启动新 Pod,中间就可能没有任何实例处理订单请求。能不能 先启动新版本,确认它能工作,再逐步停止旧版本?
Deployment 默认使用的 滚动更新(RollingUpdate) 就是为此设计的。本篇只做一件事:将订单服务从 v1 更新到 v2,再故意发布一个错误镜像,学习如何恢复到之前的可用版本。
🧱 什么是滚动更新?
假设 orders Deployment 当前运行两个 Pod,使用的都是 course-orders:v1 镜像。
更新到 v2 时,Kubernetes 不会简单地把两个旧 Pod 同时关掉。先看下面这张图,留意 新 Pod 什么时候出现、旧 Pod 什么时候退出。
两个订单 Pod 怎样逐步从 v1 变成 v2?
从上往下看:Kubernetes 先让新版本准备好,再逐步退出旧版本。
- 1
更新前:两个旧 Pod
两个 v1 Pod 都已就绪,正在处理订单请求。
Pod v1
已就绪
Pod v1
已就绪
- 2
先启动一个新 Pod
新建的 v2 Pod 还在启动,两个 v1 Pod 暂时保留。
Pod v1
已就绪
Pod v1
已就绪
Pod v2
启动中
- 3
继续替换
第一个 v2 就绪,退出一个 v1,再启动下一个 v2。
Pod v1
已就绪
Pod v2
已就绪
Pod v2
启动中
- 4
更新完成:两个新 Pod
两个 v2 Pod 都已就绪,旧版本全部退出。
Pod v2
已就绪
Pod v2
已就绪
这是一种可能的更新顺序,适用于两个副本的默认滚动更新策略。图中省略了正在退出的 Pod;实际变化还会受到就绪状态和更新配置的影响。
为什么要等新 Pod 就绪? 因为容器启动成功,不代表 Node.js 已经可以处理请求。上一篇学习的就绪探针可以帮助 Kubernetes 判断新 Pod 是否适合接收 Service 流量。
滚动更新的目的是尽可能减少发布中断, 但它不能单独保证绝对零中断。本篇先掌握最基本的替换过程,不展开复杂的发布参数。
🛠 发布订单服务 v2
1. 修改 Node.js 代码
回到前面课程的 orders-app 项目,打开 server.js,找到 /api/info 接口。
原来的响应是:
app.get('/api/info', (req, res) => {
res.json({ service: 'orders', version: 'v1' })
})
把 version 改为 v2:
app.get('/api/info', (req, res) => {
res.json({ service: 'orders', version: 'v2' })
})
这次修改了真正的应用代码,之后构建的新镜像才会包含不同的接口响应。
前面 ConfigMap 课程里的
APP_VERSION只是用于学习配置变化的环境变量;这里修改的是server.js中写明的返回值。 修改配置变量不等于升级应用镜像。
2. 构建镜像并加载到 kind
在包含 Dockerfile 的 orders-app 目录运行:
docker build -t course-orders:v2 .
模拟输出(节选):
[+] Building ... FINISHED
=> exporting to image
=> => naming to docker.io/library/course-orders:v2
构建成功后,将新镜像加载到课程使用的 kind 集群:
kind load docker-image course-orders:v2 --name node-course
模拟输出:
Image: "course-orders:v2" with ID "sha256:..." not yet present on node "node-course-control-plane", loading...
为什么还需要 kind load? 因为镜像刚刚构建在本机 Docker 中,而 kind 节点有自己的镜像存储。先加载镜像,新 Pod 才能直接找到 course-orders:v2。
3. 观察 Kubernetes 怎样替换 Pod
先确认旧版本正在运行:
kubectl get deployment orders -n course
模拟输出:
NAME READY UP-TO-DATE AVAILABLE AGE
orders 2/2 2 2 30m
为了看见新旧 Pod 共存的过程, 打开两个终端。
终端 A:先持续观察 Pod。
kubectl get pods -n course -l app=orders -w
-w 表示持续观察变化;这个终端暂时不要关闭。
终端 B:将 Deployment 使用的镜像改成 v2。
kubectl set image deployment/orders orders=course-orders:v2 -n course
模拟输出:
deployment.apps/orders image updated
命令中 deployment/orders 指的是 Deployment 名称;后面的 orders=course-orders:v2 表示把名为 orders 的容器改用 v2 镜像。
回看 终端 A,更新期间可能观察到类似变化(名称和出现顺序只是示例):
NAME READY STATUS AGE
orders-old-a 1/1 Running 10m
orders-old-b 1/1 Running 10m
orders-new-c 0/1 ContainerCreating 2s
orders-new-c 1/1 Running 8s
orders-old-a 1/1 Terminating 10m
...
你不必记住这些 Pod 名称,重点看两件事: 新 Pod 开始出现时,旧 Pod 可能还在运行;等新 Pod 就绪后,旧 Pod 才逐步退出。
本地订单服务启动得很快,可能一眨眼就更新完成,因此不一定能完整捕捉到每一行变化。这不代表滚动更新没有发生。
观察结束后,在终端 A 按 Ctrl+C,停止持续输出。
4. 确认发布成功
在终端 B 检查 Deployment:
kubectl rollout status deployment/orders -n course --timeout=120s
模拟输出:
deployment "orders" successfully rolled out
这表示新版本已满足 Deployment 的发布完成条件。再检查最终的 Pod 数量:
kubectl get pods -n course -l app=orders
模拟输出:
NAME READY STATUS RESTARTS AGE
orders-new-c 1/1 Running 0 48s
orders-new-d 1/1 Running 0 36s
最后,验证接口确实返回 v2。 终端 A 执行:
kubectl port-forward -n course service/orders 8080:80
模拟输出:
Forwarding from 127.0.0.1:8080 -> 3000
保持终端 A 运行,在 终端 B 执行:
curl http://127.0.0.1:8080/api/info
模拟响应:
{"service":"orders","version":"v2"}
现在可以确认:订单应用已经返回新代码中的版本值。
注意: kubectl port-forward service/orders 实际会选择一个匹配的 Pod 建立转发, 不是 替你轮流访问所有订单 Pod。因此,本篇用 kubectl get pods -w 观察替换过程,用 curl 验证 更新完成后 的接口结果,不用反复调用 curl 来判断新旧 Pod 是否在负载均衡。如果被选中的 Pod 退出,端口转发也可能中断。
结束验证后,在终端 A 按 Ctrl+C。
🔄 发布失败后怎样回滚?
现在 v2 已经正常运行。假设下一次发布时写错了镜像名称,Kubernetes 无法启动新 Pod,该怎么办?
1. 故意发布一个不存在的镜像
执行:
kubectl set image deployment/orders orders=course-orders:v999 -n course
模拟输出:
deployment.apps/orders image updated
虽然显示 image updated,但这只说明 Deployment 想使用的新镜像名称已经改变,不代表新 Pod 一定能启动。
查看 Pod:
kubectl get pods -n course -l app=orders
模拟输出(其中的新旧 Pod 名称仅用于区分):
NAME READY STATUS RESTARTS AGE
orders-v2-a 1/1 Running 0 3m
orders-v2-b 1/1 Running 0 3m
orders-v999-c 0/1 ImagePullBackOff 0 35s
你可能先看到 ErrImagePull,之后才出现 ImagePullBackOff。这说明新 Pod 无法取得镜像; 旧的 v2 Pod 通常会暂时保留,不会因为错误镜像就立即全部停止。
再检查发布状态,但给等待设置一个时间上限:
kubectl rollout status deployment/orders -n course --timeout=30s
模拟输出(节选):
Waiting for deployment "orders" rollout to finish...
error: timed out waiting for the condition
这里的超时表示 在等待时间内,发布没有完成,不是 Kubernetes 自动回滚了版本。
如果想看清失败原因,可以执行:
kubectl describe pods -n course -l app=orders
在新 Pod 的事件(Events)中,可能看到:
Warning Failed Failed to pull image "course-orders:v999"
Normal BackOff Back-off pulling image "course-orders:v999"
2. 恢复到之前可用的 v2
Deployment 可以保存以前的 Pod 模板修订记录。执行回滚:
kubectl rollout undo deployment/orders -n course
模拟输出:
deployment.apps/orders rolled back
由于本篇刚刚完成了 v2 发布,随后才把镜像改成错误的 v999,所以这里会尝试恢复到之前的 v2 模板。
等待恢复完成:
kubectl rollout status deployment/orders -n course --timeout=120s
模拟输出:
deployment "orders" successfully rolled out
最后检查当前 Deployment 使用什么镜像:
kubectl get deployment orders -n course -o jsonpath='{.spec.template.spec.containers[0].image}{"\n"}'
模拟输出:
course-orders:v2
到这里,错误镜像已经撤销,订单 Deployment 又恢复为 v2。你也可以重新端口转发并访问 /api/info,确认返回值仍是 v2。
3. 查看发布历史
kubectl rollout history deployment/orders -n course
模拟输出(修订号取决于你前面修改过多少次 Deployment):
deployment.apps/orders
REVISION CHANGE-CAUSE
6 <none>
7 <none>
REVISION 是 Deployment 的历史修订号,不是镜像标签。CHANGE-CAUSE 可能为 <none>,因为 Kubernetes 不会自动把每次修改都写成完整的发布说明。
回滚的边界:
rollout undo主要恢复以前的 Pod 模板,例如镜像和容器配置;它不会自动撤销数据库迁移。如果新旧应用依赖同一数据库,仍然需要保证发布过程中的数据结构和接口兼容。
❓ 知识问答
Q:滚动更新是不是保证用户请求绝对不会失败?
不是。逐步替换 Pod 可以降低中断风险,但仍受就绪检查、退出处理、可用容量等因素影响。
Q:为什么执行 kubectl set image 成功,还需要检查发布状态?
因为修改 Deployment 中的镜像名称不等于新 Pod 已经运行。镜像找不到、应用启动失败等情况,都可能让发布卡住。
Q:回滚之后,本地的 deployment.yaml 也会自动修改吗?
不会。kubectl set image 和 kubectl rollout undo 修改的是集群中的 Deployment,不会自动改写电脑里的 YAML。练习结束后,应把本地 deployment.yaml 的镜像更新为最终确认使用的 course-orders:v2,避免以后再次应用旧文件时把镜像改回 v1。其他字段保留不变。
🧪 小练习
完成一次 正常发布 → 发布失败 → 回滚恢复:
- 先确认订单 Deployment 已经有两个就绪的 v2 Pod。
- 故意把镜像名称改成不存在的
course-orders:missing,查看新 Pod 的状态与事件。 - 使用
kubectl rollout undo恢复,并确认 Deployment 最终使用course-orders:v2。 - 说出:为什么错误镜像的
kubectl set image显示成功,并不代表发布成功?
验收标准: 能看到新 Pod 的镜像拉取错误,完成回滚后看到两个就绪的 v2 Pod,并能解释滚动更新为什么不会一开始就删除全部旧 Pod。
🎉 恭喜你!现在你知道 Deployment 怎样逐步把订单服务从 v1 替换为 v2,也学会在新版本无法启动时查看原因、回滚并确认恢复结果。
