Skip to content

Commit 4b8babe

Browse files
doc update issue#51195
1 parent 8b80850 commit 4b8babe

File tree

1 file changed

+15
-7
lines changed
  • content/en/docs/concepts/workloads/pods

1 file changed

+15
-7
lines changed

content/en/docs/concepts/workloads/pods/_index.md

Lines changed: 15 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -227,16 +227,11 @@ have some limitations:
227227

228228
- Most of the metadata about a Pod is immutable. For example, you cannot
229229
change the `namespace`, `name`, `uid`, or `creationTimestamp` fields.
230-
- The `generation` field is unique. It will be automatically set by the
231-
system such that new pods have a `generation` of 1, and every update to
232-
mutable fields in the pod's spec will increment the `generation` by 1. If the
233-
alpha feature gate PodObservedGenerationTracking is set, the
234-
pod's `status.observedGeneration` will reflect the `metadata.generation` of
235-
the pod at the point that the pod status is being reported.
230+
236231
- If the `metadata.deletionTimestamp` is set, no new entry can be added to the
237232
`metadata.finalizers` list.
238233
- Pod updates may not change fields other than `spec.containers[*].image`,
239-
`spec.initContainers[*].image`, `spec.activeDeadlineSeconds` or
234+
`spec.initContainers[*].image`, `spec.activeDeadlineSeconds`, `spec.terminationGracePeriodSeconds` or
240235
`spec.tolerations`. For `spec.tolerations`, you can only add new entries.
241236
- When updating the `spec.activeDeadlineSeconds` field, two types of updates
242237
are allowed:
@@ -260,6 +255,19 @@ The above update rules apply to regular pod updates, but other pod fields can be
260255
- **Binding:** The `binding` subresource allows setting the pod's `spec.nodeName` via a `Binding` request.
261256
This is typically only used by the {{< glossary_tooltip text="scheduler" term_id="kube-scheduler" >}}.
262257

258+
### Pod generation
259+
260+
- The `generation` field is unique. It will be automatically set by the
261+
system such that new pods have a `metadata.generation` of 1, and every update to
262+
mutable fields in the pod's spec will increment the `metadata.generation` by 1.
263+
264+
{{< feature-state for_k8s_version="v1.34" state="beta" >}}
265+
266+
- `observedGeneration` is an optional field that is captured in the `status` section of the Pod
267+
object. Kubelet will set `status.observedGeneration` to track the pod state to the current pod status.
268+
The pod's `status.observedGeneration` will reflect the `metadata.generation` of the pod at the point
269+
that the pod status is being reported.
270+
263271
## Resource sharing and communication
264272

265273
Pods enable data sharing and communication among their constituent

0 commit comments

Comments
 (0)