容器与云原生 / 系统课时

容器生命周期钩子

容器生命周期钩子

本课使用 PostStart 和 PreStop 钩子,为容器增加启动后初始化与终止前排空逻辑,并通过可执行示例验证钩子的触发顺序和时间预算。完成后,你能够把钩子与应用主进程、就绪检查及优雅终止配合起来。

学习目标

  • 说明 PostStart、PreStop 与容器主进程之间的执行关系。
  • 使用 exec 处理器配置启动标记和终止前排空。
  • 验证钩子执行结果,并设计可重复、可超时控制的处理逻辑。

钩子在生命周期中的位置

PostStart 在容器创建后触发,但 Kubernetes 不保证它先于容器入口进程开始执行,因此不能依赖二者的固定先后顺序。PostStart 必须成功完成;若处理器失败,容器会被终止,并按照 Pod 的重启策略重新启动。

PreStop 在容器因删除、更新或其他管理事件终止前执行。终止宽限期的计时先开始,随后运行 PreStop;处理器完成后,容器运行时再向主进程发送终止信号。钩子耗时与应用退出耗时共享同一份 terminationGracePeriodSeconds 预算。

PostStart 与 PreStop 生命周期时序

钩子不是应用生命周期框架的替代品。主进程仍应正确处理 SIGTERM,并在收到信号后停止接收新任务、完成必要清理后退出;PreStop 更适合发出排空指令或等待短暂传播,而不是承担无法中断的长任务。

配置启动标记与优雅终止

下面的 Pod 在 PostStart 中等待 3 秒并创建标记文件,Readiness Probe 只有检测到该文件且不存在排空标记时才成功。PreStop 会先创建排空标记,再等待 5 秒,模拟实例退出负载均衡后的连接排空窗口。

yaml
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 秒等待是否计入删除过程。

bash
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

预期输出:

text
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 处理器的输出不会自动成为应用日志;生产环境应让处理器返回明确退出码,并通过事件、指标或外部状态验证执行结果。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

容器生命周期钩子

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通