容器与云原生 / 系统课时
优雅终止应用
优雅终止应用
本节解决 Pod 被删除、节点维护或发布替换时的安全退出问题:通过合理设置终止宽限期、配置 preStop,并让应用正确处理终止流程,尽量先停止接收新流量,再等待进行中的请求完成。
学习目标
- 说清 Pod 从进入 Terminating 到容器退出的关键时序。
- 配置
terminationGracePeriodSeconds与preStop钩子。 - 验证应用是否在宽限期内完成优雅退出,并识别强制终止风险。
看懂 Pod 的终止时序
当 Pod 被删除时,API 对象先进入 Terminating 状态;服务端点会异步处理该 Pod 的终止状态,kubelet 同时开始本机退出流程。若容器配置了 preStop,kubelet 会先执行钩子;钩子完成且容器仍在运行时,再向容器主进程发送 SIGTERM。宽限期耗尽后,仍未退出的进程最终会被强制结束。

这里有两个容易误判的点。第一,preStop 的执行时间也计算在终止宽限期内;第二,端点与代理的状态传播存在短暂延迟,所以不能假设 preStop 开始执行时已经绝对没有新请求。生产应用仍应具备停止接受新连接和排空在途工作的能力。
配置宽限期和 preStop
下面用两个 Nginx 副本演示。preStop 先等待 5 秒,为 Service、代理或负载均衡组件更新路由留出缓冲,再执行 nginx -s quit,让 Nginx 使用自身的优雅关闭机制结束工作进程。整个过程必须尽量在 30 秒宽限期内完成。
apiVersion: apps/v1
kind: Deployment
metadata:
name: graceful-demo
spec:
replicas: 2
selector:
matchLabels:
app: graceful-demo
template:
metadata:
labels:
app: graceful-demo
spec:
terminationGracePeriodSeconds: 30
containers:
- name: nginx
image: nginx:1.27-alpine
ports:
- containerPort: 80
lifecycle:
preStop:
exec:
command:
- /bin/sh
- -c
- sleep 5; nginx -s quit这段配置的生效行为是:Pod 终止后,kubelet 在终止流程中执行 preStop,Nginx 收到 quit 指令后停止接受新工作并等待现有连接结束;若容器已经因此正常退出,就不需要继续等待普通终止信号。验证时还应确认 Deployment 最终恢复到两个可用副本。
部署并验证终止行为
保存为 graceful-demo.yaml 后执行部署,并等待两个副本就绪:
kubectl apply -f graceful-demo.yaml
kubectl rollout status deployment/graceful-demo --timeout=120s首次执行的预期输出类似:
deployment.apps/graceful-demo created
deployment "graceful-demo" successfully rolled out实际执行期间可能先出现等待副本就绪的信息。接着自动取得一个 Pod 名称并删除它,再等待 Deployment 恢复可用状态:
POD=$(kubectl get pod -l app=graceful-demo -o jsonpath='{.items[0].metadata.name}')
kubectl delete pod "$POD"
kubectl rollout status deployment/graceful-demo --timeout=120s预期输出类似:
pod "graceful-demo-<ID>" deleted
deployment "graceful-demo" successfully rolled out<ID> 是动态 Pod 标识,实际值会不同。删除命令完成前,旧 Pod 会经历终止流程;随后 ReplicaSet 创建替代 Pod,Deployment 最终重新达到期望副本数。
生产环境的关键边界
preStop 适合做短暂等待、注销服务发现或触发应用自有的排空接口,不适合执行耗时备份、长时间外部调用或不确定次数的重试。钩子占用的时间越多,留给后续退出工作的宽限时间就越少。
如果应用无法正确完成退出、终止流程超过宽限期,最终仍可能被强制结束。可靠的优雅终止需要同时满足三个条件:流量入口尽快摘除旧 Pod、应用主动停止承接新工作、在途请求能够在宽限期内安全完成。