Skip to content

Commit 207c914

Browse files
committed
add documentation for KEP 4742
1 parent 09234f3 commit 207c914

File tree

2 files changed

+38
-0
lines changed

2 files changed

+38
-0
lines changed

content/en/docs/reference/access-authn-authz/admission-controllers.md

+23
Original file line numberDiff line numberDiff line change
@@ -761,6 +761,29 @@ metadata:
761761

762762
This 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 numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
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.

0 commit comments

Comments
 (0)