@@ -227,16 +227,11 @@ have some limitations:
227
227
228
228
- Most of the metadata about a Pod is immutable. For example, you cannot
229
229
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
+
236
231
- If the ` metadata.deletionTimestamp ` is set, no new entry can be added to the
237
232
` metadata.finalizers ` list.
238
233
- 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
240
235
` spec.tolerations ` . For ` spec.tolerations ` , you can only add new entries.
241
236
- When updating the ` spec.activeDeadlineSeconds ` field, two types of updates
242
237
are allowed:
@@ -260,6 +255,19 @@ The above update rules apply to regular pod updates, but other pod fields can be
260
255
- ** Binding:** The ` binding ` subresource allows setting the pod's ` spec.nodeName ` via a ` Binding ` request.
261
256
This is typically only used by the {{< glossary_tooltip text="scheduler" term_id="kube-scheduler" >}}.
262
257
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
+
263
271
## Resource sharing and communication
264
272
265
273
Pods enable data sharing and communication among their constituent
0 commit comments