设置容器终止消息
本文介绍如何设置容器的terminationMessagePath和terminationMessagePolicy字段,实现自定义设置容器终止消息。
Kubernetes可以通过terminationMessagePath来设置容器退出的消息来源,即当容器退出时,Kubernetes 从容器的terminationMessagePath字段中指定的终止消息文件中检索终止消息,默认值为: /dev/termination-log。
通过定制terminationMessagePath字段,可以使得Kubernetes在容器运行成功或失败时,使用指定的自定义文件中的内容来填充容器的终止消息。终止消息内容最大为4KB。
在以下示例中,配置了terminationMessagePath字段为:/tmp/termination-log,则容器将把终止消息写入/tmp/termination-log给Kubernetes接收。
apiVersion: v1
kind: Pod
metadata:
name: msg-path-demo
spec:
containers:
- name: msg-path-demo-container
image: debian
terminationMessagePath: "/tmp/termination-log"
此外,您还可以设置容器的terminationMessagePolicy字段,进一步自定义容器终止消息。该字段默认值为:File,即仅从终止消息文件中检索终止消息。您可以根据需要设置为:FallbackToLogsOnError,即在容器因错误退出时,如果终止消息文件为空,则使用容器日志输出的最后一部分内容来作为终止消息。
apiVersion: v1
kind: Pod
metadata:
name: msg-path-demo
spec:
containers:
- name: msg-path-demo-container
image: debian
terminationMessagePath: "/tmp/termination-log"
terminationMessagePolicy: "FallbackToLogsOnError"
Pod内所有容器的终止信息大小之和最大为12KB。当总和超过12KB时,Kubernetes的状态管理器会对其加以限制,例如:Pod内有4个InitContainer和8个应用Container,则状态管理器会限制每个容器的终止信息最大为1KB,即截取每个Container终止信息的前1KB。