File tree 2 files changed +38
-0
lines changed
content/en/docs/reference
command-line-tools-reference/feature-gates
2 files changed +38
-0
lines changed Original file line number Diff line number Diff line change @@ -761,6 +761,29 @@ metadata:
761
761
762
762
This admission controller is disabled by default.
763
763
764
+ # ## PodTopologyLabels {#podtopologylabels}
765
+
766
+ {{< feature-state feature_gate="PodTopologyLabelsAdmission" >}}
767
+
768
+ **Type**: Mutating
769
+
770
+ The PodTopologyLabels admission controller mutates the `pods/binding` subresources
771
+ for all pods bound to a Node, adding topology labels matching those of the bound Node.
772
+ This allows Node topology labels to be available as pod labels,
773
+ which can be surfaced to running containers using the
774
+ [Downward API](docs/concepts/workloads/pods/downward-api/).
775
+ The labels available as a result of this controller are the
776
+ [topology.kubernetes.io/region](docs/reference/labels-annotations-taints/#topologykubernetesioregion) and
777
+ [topology.kuberentes.io/zone](docs/reference/labels-annotations-taints/#topologykubernetesiozone) labels.
778
+
779
+ {{ <note> }}
780
+ If any mutating admission webhook adds or modifies labels of the `pods/binding` subresource,
781
+ these changes will propagate to pod labels as a result of this controller,
782
+ overwriting labels with conflicting keys.
783
+ {{ </note> }}
784
+
785
+ This admission controller is enabled when the `PodTopologyLabelsAdmission` feature gate is enabled.
786
+
764
787
# ## Priority {#priority}
765
788
766
789
**Type**: Mutating and Validating.
Original file line number Diff line number Diff line change
1
+ ---
2
+ title : PodTopologyLabelsAdmission
3
+ content_type : feature_gate
4
+ _build :
5
+ list : never
6
+ render : false
7
+
8
+ stages :
9
+ - stage : alpha
10
+ defaultValue : false
11
+ fromVersion : " 1.33"
12
+ ---
13
+ Enables the ` PodTopologyLabels ` admission plugin.
14
+ See [ Pod Topology Labels] ( docs/reference/access-authn-authz/admission-controllers#podtopologylabels )
15
+ for details.
You can’t perform that action at this time.
0 commit comments