Kubernetes 中支持容器的 postStart 和 preStop 事件，本文阐述了如何向容器添加生命周期事件处理程序（handler）。

  • postStart 容器启动时，Kubernetes 立刻发送 postStart 事件，但不确保对应的 handler 是否能在容器的 EntryPoint 之前执行
  • preStop 容器停止前，Kubernetes 发送 preStop 事件

    前提

您已经有一个安装好的 Kubernetes 集群，并且可以通过 kubectl 访问该集群。请参考：
安装Kubernetes单Master节点

定义postStart和preStop处理程序

下面的例子中，您将创建一个包含单一容器的 Pod，并为该容器关联 postStart 和 preStop 处理程序（handler）。Pod 的yaml文件定义如下：

  1. apiVersion: v1
  2. kind: Pod
  3. metadata:
  4.   name: lifecycle-demo
  5. spec:
  6.   containers:
  7.   - name: lifecycle-demo-container
  8.     image: nginx
  9.     lifecycle:
  10.       postStart:
  11.         exec:
  12.           command: ["/bin/sh", "-c", "echo Hello from the postStart handler > /usr/share/message"]
  13.       preStop:
  14.         exec:
  15.           command: ["/bin/sh","-c","nginx -s quit; while killall -0 nginx; do sleep 1; done"]

在该例子中，请注意：

  • postStart 命令向 usr/share/message 文件写入了一行文字

  • preStop 命令优雅地关闭了 nginx

    如果容器碰到问题，被 Kubernetes 关闭，这个操作是非常有帮助的，可以使得您的程序在关闭前执行必要的清理任务

  • 创建 Pod ```bash kubectl apply -f https://kuboard.cn/statics/learning/container/lifecycle.yaml

  2. - 验证 Pod 中的容器已经运行：
  3. ```bash
  4. kubectl get pod lifecycle-demo

  • 进入容器的命令行终端：

    1. kubectl exec -it lifecycle-demo -- /bin/bash

  • 在命令行终端中，验证 postStart 处理程序创建的 message 文件：

    1. root@lifecycle-demo:/# cat /usr/share/message

    输出结果如下所示：

    1. Hello from the postStart handler

    总结

Kubernetes 在容器启动后立刻发送 postStart 事件，但是并不能确保 postStart 事件处理程序在容器的 EntryPoint 之前执行。postStart 事件处理程序相对于容器中的进程来说是异步的（同时执行），然而，Kubernetes 在管理容器时，将一直等到 postStart 事件处理程序结束之后，才会将容器的状态标记为 Running。

Kubernetes 在决定关闭容器时，立刻发送 preStop 事件，并且，将一直等到 preStop 事件处理程序结束或者 Pod 的 —grace-period 超时，才删除容器。请参考 Termination of Pod

TIP Kubernetes 只在 Pod Teminated 状态时才发送 preStop 事件，这意味着，如果 Pod 已经进入了 Completed 状态， preStop 事件处理程序将不会被调用。这个问题已经记录在 kubernetes 的 issue 中： issue #55087