File tree Expand file tree Collapse file tree 2 files changed +38
-0
lines changed 
content/en/docs/reference 
command-line-tools-reference/feature-gates Expand file tree Collapse file tree 2 files changed +38
-0
lines changed Original file line number Diff line number Diff line change @@ -761,6 +761,29 @@ metadata:
761761
762762This admission controller is disabled by default. 
763763
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+ 
764787# ## Priority {#priority}
765788
766789**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