Convert site to Hugo (#8316)

This commit converts content and layout to use Hugo.
2018-05-05 18:00:51 +02:00
parent 7745f0e0c5
commit 7f3b633aa0
2327 changed files with 10928 additions and 171503 deletions
@@ -0,0 +1,122 @@
+---
+title: Determine the Reason for Pod Failure
+content_template: templates/task
+---
+
+{{% capture overview %}}
+
+This page shows how to write and read a Container
+termination message.
+
+Termination messages provide a way for containers to write
+information about fatal events to a location where it can
+be easily retrieved and surfaced by tools like dashboards
+and monitoring software. In most cases, information that you
+put in a termination message should also be written to
+the general
+[Kubernetes logs](/docs/concepts/cluster-administration/logging/).
+
+{{% /capture %}}
+
+
+{{% capture prerequisites %}}
+
+{{< include "task-tutorial-prereqs.md" >}} {{< version-check >}}
+
+{{% /capture %}}
+
+
+{{% capture steps %}}
+
+## Writing and reading a termination message
+
+In this exercise, you create a Pod that runs one container.
+The configuration file specifies a command that runs when
+the container starts.
+
+{{< code file="termination.yaml" >}}
+
+1. Create a Pod based on the YAML configuration file:
+
+       kubectl create -f https://k8s.io/docs/tasks/debug-application-cluster/termination.yaml
+
+    In the YAML file, in the `cmd` and `args` fields, you can see that the
+    container sleeps for 10 seconds and then writes "Sleep expired" to
+    the `/dev/termination-log` file. After the container writes
+    the "Sleep expired" message, it terminates.
+
+1. Display information about the Pod:
+
+       kubectl get pod termination-demo
+
+    Repeat the preceding command until the Pod is no longer running.
+
+1. Display detailed information about the Pod:
+
+       kubectl get pod --output=yaml
+
+    The output includes the "Sleep expired" message:
+
+        apiVersion: v1
+        kind: Pod
+        ...
+            lastState:
+              terminated:
+                containerID: ...
+                exitCode: 0
+                finishedAt: ...
+                message: |
+                  Sleep expired
+                ...
+
+1. Use a Go template to filter the output so that it includes
+only the termination message:
+
+```
+  kubectl get pod termination-demo -o go-template="{{range .status.containerStatuses}}{{.lastState.terminated.message}}{{end}}"
+```
+
+## Customizing the termination message
+
+Kubernetes retrieves termination messages from the termination message file
+specified in the `terminationMessagePath` field of a Container, which as a default
+value of `/dev/termination-log`. By customizing this field, you can tell Kubernetes
+to use a different file. Kubernetes use the contents from the specified file to
+populate the Container's status message on both success and failure.
+
+In the following example, the container writes termination messages to
+`/tmp/my-log` for Kubernetes to retrieve:
+
+```yaml
+apiVersion: v1
+kind: Pod
+metadata:
+  name: msg-path-demo
+spec:
+  containers:
+  - name: msg-path-demo-container
+    image: debian
+    terminationMessagePath: "/tmp/my-log"
+```
+
+Moreover, users can set the `terminationMessagePolicy` field of a Container for
+further customization. This field defaults to "`File`" which means the termination
+messages are retrieved only from the termination message file. By setting the
+`terminationMessagePolicy` to "`FallbackToLogsOnError`", you can tell Kubernetes
+to use the last chunk of container log output if the termination message file
+is empty and the container exited with an error. The log output is limited to
+2048 bytes or 80 lines, whichever is smaller.
+
+{{% /capture %}}
+
+{{% capture whatsnext %}}
+
+* See the `terminationMessagePath` field in
+  [Container](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#container-v1-core).
+* Learn about [retrieving logs](/docs/concepts/cluster-administration/logging/).
+* Learn about [Go templates](https://golang.org/pkg/text/template/).
+
+{{% /capture %}}
+
+
+