# 容器生命周期事件处理
参考文档: Attach Handlers to Container Lifecycle Events (opens new window)
Kubernetes 中支持容器的 postStart 和 preStop 事件,本文阐述了如何向容器添加生命周期事件处理程序(handler)。
postStart
容器启动时,Kubernetes 立刻发送 postStart 事件,但不确保对应的 handler 是否能在容器的EntryPoint
之前执行preStop
容器停止前,Kubernetes 发送 preStop 事件
# 前提
您已经有一个安装好的 Kubernetes 集群,并且可以通过 kubectl 访问该集群。请参考:
# 定义postStart和preStop处理程序
下面的例子中,您将创建一个包含单一容器的 Pod,并为该容器关联 postStart 和 preStop 处理程序(handler)。Pod 的yaml文件定义如下:
apiVersion: v1
kind: Pod
metadata:
name: lifecycle-demo
spec:
containers:
- name: lifecycle-demo-container
image: nginx
lifecycle:
postStart:
exec:
command: ["/bin/sh", "-c", "echo Hello from the postStart handler > /usr/share/message"]
preStop:
exec:
command: ["/bin/sh","-c","nginx -s quit; while killall -0 nginx; do sleep 1; done"]
2
3
4
5
6
7
8
9
10
11
12
13
14
15
在该例子中,请注意:
postStart 命令向
usr/share/message
文件写入了一行文字preStop 命令优雅地关闭了 nginx
如果容器碰到问题,被 Kubernetes 关闭,这个操作是非常有帮助的,可以使得您的程序在关闭前执行必要的清理任务
创建 Pod
kubectl apply -f https://kuboard.cn/statics/learning/container/lifecycle.yaml
1验证 Pod 中的容器已经运行:
kubectl get pod lifecycle-demo
1进入容器的命令行终端:
kubectl exec -it lifecycle-demo -- /bin/bash
1在命令行终端中,验证
postStart
处理程序创建的message
文件:root@lifecycle-demo:/# cat /usr/share/message
1输出结果如下所示:
Hello from the postStart handler
1
# 总结
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 (opens new window)