容器与云原生 / 系统课时
设计 preStop 与摘流等待
设计 preStop 与摘流等待
Pod 进入终止阶段时,流量摘除、代理收敛与容器退出并不会形成由 preStop 保证的严格先后关系。本课用一个可验证的 Deployment,明确 preStop 的边界,并把摘流传播、Hook 等待和应用优雅退出放进同一个终止预算。
学习目标
- 判断
preStop能缓解什么问题,以及它不能保证什么 - 根据实测传播时间和应用退出时间设计终止预算
- 用连续请求验证滚动更新期间是否出现连接错误
先看清并行发生的终止过程
删除 Pod 或滚动更新旧副本后,Pod 会进入终止流程,EndpointSlice 也会反映终止状态,使该 Pod 不再作为普通就绪后端继续接收新流量。但 kube-proxy、Ingress、服务网格、外部负载均衡和客户端连接池对这一变化的感知都可能存在传播延迟。
与此同时,kubelet 会启动 Pod 的终止宽限期计时;如果容器定义了 preStop,会先执行 Hook,Hook 结束后再向容器发送终止信号。这里的“先”只描述容器本地生命周期:它不表示 EndpointSlice、代理或负载均衡已经完成收敛,也不存在“等摘流完成后才执行应用退出”的全局顺序保证。

配置一个可测量的等待窗口
下面的 Deployment 为容器设置 10 秒 preStop,并给整个 Pod 30 秒终止宽限期。宽限期计时会覆盖 preStop 的执行时间,因此这 10 秒不是额外赠送的退出时间。
apiVersion: apps/v1
kind: Deployment
metadata:
name: drain-demo
spec:
replicas: 2
selector:
matchLabels:
app: drain-demo
template:
metadata:
labels:
app: drain-demo
spec:
terminationGracePeriodSeconds: 30
containers:
- name: app
image: nginx:1.27
ports:
- containerPort: 80
lifecycle:
preStop:
exec:
command: ["/bin/sh", "-c", "sleep 10"]
---
apiVersion: v1
kind: Service
metadata:
name: drain-demo
spec:
selector:
app: drain-demo
ports:
- port: 80
targetPort: 80这是配置文件,不产生固定控制台输出。应用后可检查 Pod 模板中的终止宽限期和 Hook:
kubectl get deployment drain-demo -o jsonpath='{.spec.template.spec.terminationGracePeriodSeconds}{"\n"}{.spec.template.spec.containers[0].lifecycle.preStop.exec.command}{"\n"}'预期输出:
30
[/bin/sh -c sleep 10]实际资源名称和命名空间可能不同。
用终止预算设计,而不是固定写 sleep
设计时应先测量“Pod 被标记终止后,链路中最后一批新连接仍可能到达旧 Pod”的时间分布,再决定是否需要 preStop。如果确实需要固定等待,更直接的预算关系是:
preStop 等待时间 + 应用收到终止信号后的最长退出时间 + 安全余量 <= terminationGracePeriodSeconds
例如,连续演练发现绝大多数旧路由在 6 秒内消失,可以把 8~10 秒作为待验证的等待起点;若应用收到终止信号后最多还需要 8 秒处理在途请求,再预留数秒安全余量,30 秒宽限期通常比把 preStop 和宽限期都设成 30 秒更合理。
不要让 preStop 替代应用排空
preStop 不能替代应用对终止信号的处理。应用仍应在收到终止信号后停止接受新的业务工作、完成或中止已有请求,并在预算内退出。若入口代理本身提供可靠的连接排空机制,而且实测没有明显的旧后端传播尾部,额外的固定 sleep 只会拉长发布时间。
反过来,请求经过外部负载均衡、Ingress、服务网格和客户端连接池等多层组件时,短暂的 preStop 可以作为兼容性缓冲,但它始终是基于观测结果设置的概率性窗口,而不是摘流完成的确认机制。
用连续请求验收滚动更新
验收时应同时制造持续流量和滚动更新。下面命令从临时客户端 Pod 每 0.2 秒访问一次 Service;另一个终端触发滚动重启并等待完成。
kubectl run drain-client --rm -i --restart=Never --image=curlimages/curl:8.10.1 -- sh -c 'while true; do code=$(curl -sS -o /dev/null -w "%{http_code}" --max-time 2 http://drain-demo); echo "$code"; sleep 0.2; done'预期输出:
200
200
200
<持续输出;滚动更新期间不应出现连接失败对应的非 200 状态>在另一个终端执行:
kubectl rollout restart deployment/drain-demo
kubectl rollout status deployment/drain-demo预期结果:
deployment "drain-demo" successfully rolled outPod 名称、时间和中间状态会因集群而异。真正的验收标准不是“preStop 执行了 10 秒”或“Pod 最终能退出”,而是连续请求在终止窗口内没有新增连接错误,同时应用仍有足够预算完成自己的优雅退出。