Managing Node Labels

You can add different labels to nodes and define different attributes for labels. By using these node labels, you can quickly understand the characteristics of each node.

Node Label Usage Scenario

Node labels are mainly used in the following scenarios:

Node management: Node labels are used to classify nodes.
Node affinity or anti-affinity for workloads: By adding labels to nodes, you can schedule pods to specific nodes through node affinity or prevent pods from being scheduled to specific nodes through node anti-affinity. For details, see Configuring Node Affinity Scheduling (nodeAffinity).

Inherent Labels of a Node

After a node is created, some fixed labels exist and cannot be deleted. For details about these labels, see Table 1.

Do not manually modify system labels automatically applied to nodes. System values take precedence over conflicting manual changes.

**Table 1** Inherent labels of a node
Key	Description
New: topology.kubernetes.io/region Old: failure-domain.beta.kubernetes.io/region	Region where the node is located
New: topology.kubernetes.io/zone Old: failure-domain.beta.kubernetes.io/zone	AZ where the node is located
New: node.kubernetes.io/baremetal Old: failure-domain.beta.kubernetes.io/is-baremetal	Whether it is a bare metal node false indicates that the node is not a bare metal node.
node.kubernetes.io/container-engine	Container runtime Example: docker or containerd
node.kubernetes.io/instance-type beta.kubernetes.io/instance-type	Node specifications
kubernetes.io/arch beta.kubernetes.io/arch	Node processor architecture
kubernetes.io/hostname	Node name
kubernetes.io/os beta.kubernetes.io/os	Node OS type
node.kubernetes.io/subnetid	ID of the subnet where the node is located
os.architecture	Node processor architecture For example, amd64 indicates a AMD64-bit processor.
os.name	Node OS name
os.version	Node OS kernel version
accelerator/huawei-npu	NPU node label
accelerator	GPU node label
cce.cloud.com/cce-nodepool	The dedicated label of a node in a node pool, indicating the node pool name
cce.cloud.com/cce-nodepool-id	The dedicated label of a node in a node pool, indicating the node pool ID
node.cce.io/billing-mode	Node billing mode
node.cce.io/eni-network-mode	The type of network interfaces used by pods on a node. This label is available only for nodes in CCE Turbo clusters.

Adding, Updating, or Deleting a Node Label

Log in to the CCE console and click the cluster name to access the cluster console.
In the navigation pane, choose Nodes. On the displayed page, click the Nodes tab, select the target node and click Manage Labels and Taints above the node list.
In the displayed window, click Add Operation under Batch Operation, and then choose Add/Update or Delete.

Enter the key and value of the label to be added, updated, or deleted, and click OK.

For example, the key is deploy_qa and the value is true, indicating that the node is used to deploy the QA (test) environment.

Figure 1 Adding a node label
Check the added label in node data.