文档

设置容器终止消息

更新时间:

在Kubernetes中,terminationMessagePath和terminationMessagePolicy用于指定容器终止消息的来源路径和策略。本文介绍如何设置terminationMessagePath和terminationMessagePolicy,以便在容器终止后能够及时获取和分析终止消息。

配置说明

Kubernetes通过terminationMessagePath和terminationMessagePolicy管理容器终止消息。

字段

说明

terminationMessagePath

用于设置容器终止的消息来源。即当容器退出时,Kubernetes 从容器的terminationMessagePath字段中指定的终止消息文件中检索终止消息。默认值为 /dev/termination-log

通过自定义设置terminationMessagePath,可以使得Kubernetes在容器运行成功或失败时,使用指定文件中的内容来填充容器的终止消息。终止消息内容最大为4 KB。

terminationMessagePolicy

用于设置容器终止消息的策略。取值为:

  • File(默认):仅从终止消息文件中检索终止消息。

  • FallbackToLogsOnError:在容器因错误退出时,如果终止消息文件为空,则使用容器日志输出的最后一部分内容来作为终止消息。

说明

Pod内所有容器的终止信息大小之和最大为12 KB。当总和超过12 KB时,Kubernetes的状态管理器会对其加以限制。例如:Pod内有4个InitContainer和8个应用Container,则状态管理器会限制每个容器的终止信息最大为1 KB,即截取每个Container终止信息的前1 KB。

配置示例

在以下示例中,配置了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: registry.cn-shanghai.aliyuncs.com/eci_open/nginx:1.14.2
    terminationMessagePath: "/tmp/termination-log"

此外,您还可以设置容器的terminationMessagePolicy字段,进一步设置容器终止消息的策略。

apiVersion: v1
kind: Pod
metadata:
  name: msg-path-demo
spec:
  containers:
  - name: msg-path-demo-container
    image: registry.cn-shanghai.aliyuncs.com/eci_open/nginx:1.14.2
    terminationMessagePath: "/tmp/termination-log"
    terminationMessagePolicy: "FallbackToLogsOnError"