Skip to content

Commit

Permalink
Link to specific node labels rather than entire list
Browse files Browse the repository at this point in the history
Less visual space compared to the original approach, but still shows
which labels you can expect to find set on a node.

Co-authored-by: Ritikaa96 <[email protected]>
  • Loading branch information
sftim and Ritikaa96 committed Jul 27, 2023
1 parent ae9e828 commit 29c6a60
Show file tree
Hide file tree
Showing 3 changed files with 39 additions and 3 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -36,8 +36,7 @@ specific Pods:

Like many other Kubernetes objects, nodes have
[labels](/docs/concepts/overview/working-with-objects/labels/). You can [attach labels manually](/docs/tasks/configure-pod-container/assign-pods-nodes/#add-a-label-to-a-node).
Kubernetes also populates a standard set of labels on all nodes in a cluster. See [Well-Known Labels, Annotations and Taints](/docs/reference/labels-annotations-taints/)
for a list of common node labels.
Kubernetes also populates a [standard set of labels](/docs/reference/node/node-labels/) on all nodes in a cluster.

{{<note>}}
The value of these labels is cloud provider specific and is not guaranteed to be reliable.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
content_type: "reference"
title: Kubelet Device Manager API Versions
weight: 10
weight: 50
---

This page provides details of version compatibility between the Kubernetes
Expand Down
37 changes: 37 additions & 0 deletions content/en/docs/reference/node/node-labels.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
---
content_type: "reference"
title: Node Labels Populated By The Kubelet
weight: 40
---

Kubernetes {{< glossary_tooltip text="nodes" term_id="node" >}} come pre-populated
with a standard set of {{< glossary_tooltip text="labels" term_id="label" >}}.

You can also set your own labels on nodes, either through the kubelet configuration or
using the Kubernetes API.

## Preset labels

The preset labels that Kubernetes sets on nodes are:

* [`kubernetes.io/arch`](/docs/reference/labels-annotations-taints/#kubernetes-io-arch)
* [`kubernetes.io/hostname`](/docs/reference/labels-annotations-taints/#kubernetes-io-hostname)
* [`kubernetes.io/os`](/docs/reference/labels-annotations-taints/#kubernetes-io-os)
* [`node.kubernetes.io/instance-type`](/docs/reference/labels-annotations-taints/#nodekubernetesioinstance-type)
(if known to the kubelet &ndash; Kubernetes may not have this information to set the label)
* [`topology.kubernetes.io/region`](/docs/reference/labels-annotations-taints/#topologykubernetesioregion)
(if known to the kubelet &ndash; Kubernetes may not have this information to set the label)
* [`topology.kubernetes.io/zone`](/docs/reference/labels-annotations-taints/#topologykubernetesiozone)
(if known to the kubelet &ndash; Kubernetes may not have this information to set the label)

{{<note>}}
The value of these labels is cloud provider specific and is not guaranteed to be reliable.
For example, the value of `kubernetes.io/hostname` may be the same as the node name in some environments
and a different value in other environments.
{{</note>}}

## {{% heading "whatsnext" %}}

- See [Well-Known Labels, Annotations and Taints](/docs/reference/labels-annotations-taints/) for a list of common labels.
- Learn how to [add a label to a node](/docs/tasks/configure-pod-container/assign-pods-nodes/#add-a-label-to-a-node).

0 comments on commit 29c6a60

Please sign in to comment.