website/content/zh/docs/tasks/configure-pod-container/attach-handler-lifecycle-event.md

title, content_template, weight

title	content_template	weight
为容器生命周期事件添加处理程序	templates/task	140

{{% capture overview %}}

本页面展示了如何将容器生命周期事件绑定到处理程序上。Kubernetes 支持 postStart 和 preStop 事件。Kubernetes 在启动容器之后会立即发送 postStart 事件 ，在容器终止之前会立即发送 preStop 事件。

{{% /capture %}}

{{% capture prerequisites %}}

{{< include "task-tutorial-prereqs.md" >}} {{< version-check >}}

{{% /capture %}}

{{% capture steps %}}

定义 postStart 和 preStop 处理程序

在本练习中，您将创建一个具有一个容器的 Pod。该容器包含用于处理 postStart 和 preStop 事件的程序。

这是 Pod 的配置文件：

{{< codenew file="pods/lifecycle-events.yaml" >}}

在配置文件中，您可以看到 postStart 命令写入 message 文件到容器的的 /usr/share 目录。preStop 命令优雅地关闭了 nginx 。如果容器因故障而终止，这就会非常有用。

创建 Pod:

kubectl create -f https://k8s.io/examples/pods/lifecycle-events.yaml

验证 Pod 里的容器处于运行状态:

kubectl get pod lifecycle-demo

获取一个访问 Pod 中运行容器的 shell:

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

在 shell 中，验证 postStart 处理程序是否创建了 message 文件:

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

输出显示 postStart 处理程序写入的文本:

Hello from the postStart handler

{{% /capture %}}

{{% capture discussion %}}

讨论

Kubernetes 在创建容器后立即发送 postStart 事件。但是，不能保证 postStart 处理程序 在容器的 entrypoint 调用之前被调用。相对于容器的代码，postStart 处理程序以异步方式运行，但 Kubernetes 对容器的管理 会阻塞直到 postStart 处理程序完成。容器的状态直到 postStart 处理程序完成后才会设置为 RUNNING 。

Kubernetes 在容器终止之前立即发送 preStop 事件。 Kubernetes 对容器的管理一直阻塞直到 preStop 处理程序完成， 除非 Pod 的宽限期过期。有关详细信息，请参阅 Pods 的终止 。

{{< note >}}

Kubernetes 仅在 Pod 是 terminated 时发送 preStop 事件。这意味着当 Pod 是 completed 状态时，preStop 钩子程序不会被触发。 这个限制被记录在 issue #55087 中。 {{< /note >}}

{{% /capture %}}

{{% capture whatsnext %}}

• 进一步了解 容器生命周期钩子.
• 进一步了解 Pod 的生命周期.

参考

• [Lifecycle](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#lifecycle-v1-core)
• [Container](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#container-v1-core)
• 查看 [PodSpec](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#podspec-v1-core) 文档中关于 terminationGracePeriodSeconds 的说明

{{% /capture %}}