容器与云原生 / 系统课时
容器生命周期钩子
容器生命周期钩子
本课使用 PostStart 和 PreStop 钩子,为容器增加启动后初始化与终止前排空逻辑,并通过可执行示例验证钩子的触发顺序和时间预算。完成后,你能够把钩子与应用主进程、就绪检查及优雅终止配合起来。
学习目标
- 说明 PostStart、PreStop 与容器主进程之间的执行关系。
- 使用
exec处理器配置启动标记和终止前排空。 - 验证钩子执行结果,并设计可重复、可超时控制的处理逻辑。
钩子在生命周期中的位置
PostStart 在容器创建后触发,但 Kubernetes 不保证它先于容器入口进程开始执行,因此不能依赖二者的固定先后顺序。PostStart 必须成功完成;若处理器失败,容器会被终止,并按照 Pod 的重启策略重新启动。
PreStop 在容器因删除、更新或其他管理事件终止前执行。终止宽限期的计时先开始,随后运行 PreStop;处理器完成后,容器运行时再向主进程发送终止信号。钩子耗时与应用退出耗时共享同一份 terminationGracePeriodSeconds 预算。

钩子不是应用生命周期框架的替代品。主进程仍应正确处理 SIGTERM,并在收到信号后停止接收新任务、完成必要清理后退出;PreStop 更适合发出排空指令或等待短暂传播,而不是承担无法中断的长任务。
配置启动标记与优雅终止
下面的 Pod 在 PostStart 中等待 3 秒并创建标记文件,Readiness Probe 只有检测到该文件且不存在排空标记时才成功。PreStop 会先创建排空标记,再等待 5 秒,模拟实例退出负载均衡后的连接排空窗口。
apiVersion: v1
kind: Pod
metadata:
name: lifecycle-demo
spec:
terminationGracePeriodSeconds: 20
containers:
- name: worker
image: busybox:1.36.1
command:
- /bin/sh
- -c
- |
trap 'echo "main process received TERM"; exit 0' TERM
echo "main process started"
while true; do sleep 1; done
lifecycle:
postStart:
exec:
command:
- /bin/sh
- -c
- sleep 3; touch /tmp/poststart.done
preStop:
exec:
command:
- /bin/sh
- -c
- touch /tmp/draining; sleep 5
readinessProbe:
exec:
command:
- /bin/sh
- -c
- test -f /tmp/poststart.done && test ! -f /tmp/draining
periodSeconds: 1
failureThreshold: 1这里把就绪条件与 PostStart 的结果关联起来,使容器主进程即使已经运行,也要等初始化完成后才接收流量。终止开始后,Kubernetes 会把 Pod 标记为正在终止;PreStop 中的排空标记则为应用提供额外状态,使仍在处理中的逻辑能够拒绝新任务。
运行并验证钩子行为
将配置保存为 lifecycle-demo.yaml。创建 Pod 后等待 Ready,再检查 PostStart 标记。最后使用 time 删除 Pod,观察 PreStop 的 5 秒等待是否计入删除过程。
kubectl apply -f lifecycle-demo.yaml
kubectl wait --for=condition=Ready pod/lifecycle-demo --timeout=30s
kubectl exec lifecycle-demo -- test -f /tmp/poststart.done && echo "postStart marker exists"
time kubectl delete pod lifecycle-demo预期输出:
pod/lifecycle-demo created
pod/lifecycle-demo condition met
postStart marker exists
pod "lifecycle-demo" deleted
real 0m<SECONDS>s
user 0m<SECONDS>s
sys 0m<SECONDS>s实际格式取决于当前 Shell,<SECONDS> 也会受集群和网络开销影响,但 real 通常不少于 PreStop 的 5 秒等待时间。删除时可在另一个终端执行 kubectl get pod lifecycle-demo -w,观察 Pod 进入 Terminating 后再被移除。
设计可靠钩子的边界
钩子处理器应具备幂等性,因为 kubelet 异常恢复等场景可能造成重复调用。初始化操作可先检查目标状态,清理操作也应允许资源已经释放,避免第二次执行时返回错误并阻断容器生命周期。
PreStop 必须短于终止宽限期,并为主进程处理 SIGTERM 留出余量。例如宽限期为 20 秒时,不要让钩子占满 20 秒。强制删除或节点突然断电无法保证钩子完成,因此关键数据一致性不能只依赖 PreStop。
钩子失败时应查看 Pod 事件,而不是只看容器标准输出。exec 处理器的输出不会自动成为应用日志;生产环境应让处理器返回明确退出码,并通过事件、指标或外部状态验证执行结果。