K8S生命周期---钩子函数(postStart/preStop)

容器生命周期钩子

容器生命周期钩子(Container Lifecycle Hooks)监听容器生命周期的特定事件,并在事件发生时执行已注册的回调函数。

支持两种钩子:

  • postStart: 容器创建后立即执行,注意由于是异步执行,它无法保证一定在 ENTRYPOINT 之前运行。如果失败,容器会被杀死,并根据 RestartPolicy 决定是 否重启
  • preStop:容器终止前执行,常用于资源清理。执行完成之后容器将成功终止,如果失败,容器同样也会被杀死。在其完成之前 会阻塞删除容器的操作

钩子的回调函数支持三种方式定义动作:

  • exec:在容器内执行命令,如果命令的退出状态码是 0 表示执行成功,否则表示失败
……
  lifecycle:
    postStart:
      exec:
        command:
        - cat
        - /tmp/healthy
……
  • httpGet:向指定 URL 发起 GET 请求,如果返回的 HTTP 状态码在 [200, 400) 之间表示请求成功,否则表示失败
……
  lifecycle:
    postStart:
      httpGet:
        path: /login   # URI地址
        port: 80  # 端口号
        host: 192.168.126.100 # 主机地址
        scheme: HTTP   # 支持的协议,http或https

# http://192.168.126.100:80/login
……
  • TCPSocket:在容器尝试访问指定的socket
……
  lifecycle:
    postStart:
      tcpSocket:
        port: 8080
……

查看具体写法:

[root@k8s-master ~]# kubectl explain pod.spec.containers.lifecycle.postStart
KIND:     Pod
VERSION:  v1
RESOURCE: postStart <Object>

FIELDS:
   exec	<Object>     

   httpGet	<Object>     

   tcpSocket	<Object>     

[root@k8s-master ~]# kubectl explain pod.spec.containers.lifecycle.preStop
KIND:     Pod
VERSION:  v1
RESOURCE: preStop <Object>

FIELDS:
   exec	<Object>
  
   httpGet	<Object>     

   tcpSocket	<Object>        

演示

[root@k8s-master ~]# vim pod-hook-exec.yaml
apiVersion: v1
kind: Pod
metadata:
  name: pod-hook-exec
  namespace: test
spec:
  containers:
  - name: main-container
    image: nginx:1.17.1
    ports:
    - name: nginx-port
      containerPort: 80
    lifecycle:
      postStart:
        exec:    # 在容器启动的时候执行一个命令,修改nginx默认首页内容
          command: ["/bin/sh","-c","echo postStart... > /usr/share/nginx/html/index.html"]
      preStop:
        exec:    # 在容器停止之前停止nginx服务
          command: ["/usr/sbin/nginx","-s","quit"]

[root@k8s-master ~]# kubectl create -f pod-hook-exec.yaml
pod/pod-hook-exec created
[root@k8s-master ~]# kubectl get pod -n test -o wide
NAME            READY   STATUS    RESTARTS   AGE   IP            NODE         NOMINATED NODE   READINESS GATES
pod-hook-exec   1/1     Running   0          19s   10.244.2.31   k8s-node02   <none>           <none>
[root@k8s-master ~]# curl 10.244.2.31
postStart...
上一篇:正则表达式中test() exec() match()详解


下一篇:linux-进程控制