kubernetes
/
website
mirror of https://github.com/kubernetes/website.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Merge pull request #48496 from alaypatel07/4017-pod-index-label-ga 

[KEP 4017]: add documentation for PodIndexLabel going GA
pull/48797/head
Kubernetes Prow Robot 2024-11-26 00:36:56 +00:00 committed by GitHub
parent 64ac7c4098 e73dcd94c6
commit 1ce3733ea2
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 7 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
content/en/docs/concepts/workloads/controllers/statefulset.md
View File

@ -252,13 +252,13 @@ the StatefulSet.
### Pod index label ### Pod index label
{{< feature-state for_k8s_version="v1.28" state="beta" >}} {{< feature-state feature_gate_name="PodIndexLabel" >}}
When the StatefulSet {{<glossary_tooltip text="controller" term_id="controller">}} creates a Pod, When the StatefulSet {{<glossary_tooltip text="controller" term_id="controller">}} creates a Pod,
the new Pod is labelled with `apps.kubernetes.io/pod-index`. The value of this label is the ordinal index of the new Pod is labelled with `apps.kubernetes.io/pod-index`. The value of this label is the ordinal index of
the Pod. This label allows you to route traffic to a particular pod index, filter logs/metrics the Pod. This label allows you to route traffic to a particular pod index, filter logs/metrics
using the pod index label, and more. Note the feature gate `PodIndexLabel` must be enabled for this using the pod index label, and more. Note the feature gate `PodIndexLabel` is enabled and locked by default for this
feature, and it is enabled by default. feature, in order to disable it, users will have to use server emulated version v1.31.
## Deployment and Scaling Guarantees ## Deployment and Scaling Guarantees

4
content/en/docs/reference/command-line-tools-reference/feature-gates/pod-index-label.md
View File

@ -9,5 +9,9 @@ stages:
- stage: beta - stage: beta
defaultValue: true defaultValue: true
fromVersion: "1.28" fromVersion: "1.28"
toVersion: "1.31"
- stage: stable
defaultValue: true
fromVersion: "1.32"
--- ---
Enables the Job controller and StatefulSet controller to add the pod index as a label when creating new pods. See [Job completion mode docs](/docs/concepts/workloads/controllers/job#completion-mode) and [StatefulSet pod index label docs](/docs/concepts/workloads/controllers/statefulset/#pod-index-label) for more details. Enables the Job controller and StatefulSet controller to add the pod index as a label when creating new pods. See [Job completion mode docs](/docs/concepts/workloads/controllers/job#completion-mode) and [StatefulSet pod index label docs](/docs/concepts/workloads/controllers/statefulset/#pod-index-label) for more details.