Skip to content

Commit 38fc6a8

Browse files
authored
Disambiguate Pod Phase from kubectl status
This PR extends kubernetes#46299, which disambiguates pod "Phase" from the "Status" field that occurs in certain kubectl commands.
1 parent a0dd39b commit 38fc6a8

File tree

1 file changed

+14
-2
lines changed

1 file changed

+14
-2
lines changed

Diff for: content/en/docs/concepts/workloads/pods/pod-lifecycle.md

+14-2
Original file line numberDiff line numberDiff line change
@@ -111,8 +111,20 @@ Value | Description
111111
`Unknown` | For some reason the state of the Pod could not be obtained. This phase typically occurs due to an error in communicating with the node where the Pod should be running.
112112

113113
{{< note >}}
114-
When a Pod is being deleted, it is shown as `Terminating` by some kubectl commands.
115-
This `Terminating` status is not one of the Pod phases.
114+
115+
When a pod is failing to start repeatedly, `CrashLoopBackOff` may appear in the `Status` field of some kubectl commands. Similarly, when a pod is being deleted, `Terminating` may appear in the `Status` field of some kubectl commands.
116+
117+
Make sure not to confuse _Status_, a kubectl display field for user intuition, with the pod's `phase`.
118+
Pod phase is an explicit part of the Kubernetes data model and of the
119+
[Pod API](/docs/reference/kubernetes-api/workload-resources/pod-v1/).
120+
121+
```
122+
NAMESPACE NAME READY STATUS RESTARTS AGE
123+
alessandras-namespace alessandras-pod 0/1 CrashLoopBackOff 200 2d9h
124+
```
125+
126+
---
127+
116128
A Pod is granted a term to terminate gracefully, which defaults to 30 seconds.
117129
You can use the flag `--force` to [terminate a Pod by force](/docs/concepts/workloads/pods/pod-lifecycle/#pod-termination-forced).
118130
{{< /note >}}

0 commit comments

Comments
 (0)