Skip to content

Commit 76806ad

Browse files
committed
Added entry for
1 parent 3aefd43 commit 76806ad

File tree

2 files changed

+17
-4
lines changed
  • content/en/docs

2 files changed

+17
-4
lines changed

content/en/docs/concepts/architecture/nodes.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -140,7 +140,9 @@ When you want to create Node objects manually, set the kubelet flag `--register-
140140
You can modify Node objects regardless of the setting of `--register-node`.
141141
For example, you can set labels on an existing Node or mark it unschedulable.
142142

143-
You can set optional node role for nodes by adding `node-role.kubernetes.io/<role>=` label to the node where characters of `<role>` are limited by the [syntax](https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#syntax-and-character-set) rules of labels.
143+
You can set optional node role(s) for nodes by adding one or more `node-role.kubernetes.io/<role>: <role>` labels to the node where characters of `<role>` are limited by the [syntax](https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#syntax-and-character-set) rules for labels.
144+
145+
Kubernetes ignores the label value for node roles;by convention, you can set it to the same string you used for the node role in label key.
144146

145147
You can use labels on Nodes in conjunction with node selectors on Pods to control
146148
scheduling. For example, you can constrain a Pod to only be eligible to run on

content/en/docs/reference/labels-annotations-taints/_index.md

Lines changed: 14 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2735,11 +2735,22 @@ only onto these nodes, or to avoid running Pods on the control plane.
27352735
If this label is set, the [EndpointSlice controller](/docs/concepts/services-networking/topology-aware-routing/#implementation-control-plane)
27362736
ignores that node while calculating Topology Aware Hints.
27372737

2738+
### node-role.kubernetes.io/*
2739+
2740+
Type: Label
2741+
2742+
Example: `node-role.kubernetes.io/*: *`
2743+
2744+
Used on: Node
2745+
2746+
This label is applied to a node when we want to register a custom node role.
2747+
Here `*` can be any node role that satisfies the [syntax](https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#syntax-and-character-set) rules for labels.
2748+
27382749
### node-role.kubernetes.io/control-plane {#node-role-kubernetes-io-control-plane-taint}
27392750

27402751
Type: Taint
27412752

2742-
Example: `node-role.kubernetes.io/*:NoSchedule`
2753+
Example: `node-role.kubernetes.io/control-plane:NoSchedule`
27432754

27442755
Used on: Node
27452756

@@ -2751,7 +2762,7 @@ be scheduled onto them. You can manually remove this taint with the following
27512762
command on a specific node.
27522763

27532764
```shell
2754-
kubectl taint nodes <node-name> node-role.kubernetes.io/*:NoSchedule-
2765+
kubectl taint nodes <node-name> node-role.kubernetes.io/control-plane:NoSchedule-
27552766
```
27562767

27572768
### node-role.kubernetes.io/master (deprecated) {#node-role-kubernetes-io-master-taint}
@@ -2760,7 +2771,7 @@ Type: Taint
27602771

27612772
Used on: Node
27622773

2763-
Example: `node-role.kubernetes.io/*:NoSchedule`
2774+
Example: `node-role.kubernetes.io/master:NoSchedule`
27642775

27652776
Taint that kubeadm previously applied on control plane nodes to allow only critical
27662777
workloads to schedule on them. Replaced by the

0 commit comments

Comments
 (0)