Uso de etiquetas de clúster en AKS habilitadas por Azure Arc

2025-04-18

Se aplica a: AKS en Azure Local

Si tiene varios grupos de nodos, es posible que quiera agregar una etiqueta durante la creación del grupo de nodos. Las etiquetas de Kubernetes controlan las reglas de programación de los nodos.

En este artículo se describe cómo usar etiquetas en un clúster de Kubernetes en AKS habilitado por Arc.

Creación de un clúster de Kubernetes con una etiqueta

Cree un clúster de Kubernetes con una etiqueta mediante el comando az aksarc create y especifique el parámetro --node-labels para establecer sus etiquetas. Las etiquetas deben ser un par clave-valor y tener una sintaxis válida.
```
az aksarc create --resource-group myResourceGroup --name myAKSCluster --node-count 2 --nodepool-labels dept=IT
```
Compruebe que las etiquetas se establecieron mediante el kubectl get nodes --show-labels comando :
```
kubectl get nodes --show-labels | grep -e "dept=IT"
```

Creación de un grupo de nodos con una etiqueta

Cree un grupo de nodos con una etiqueta con el comando az aksarc nodepool add y especifique un nombre para los parámetros --name y las etiquetas del parámetro --labels. Las etiquetas deben ser un par clave-valor y tener una sintaxis válida.

En el ejemplo siguiente se crea un grupo de nodos denominado labelnp con la etiqueta dept=HR:
```
az aksarc nodepool add --resource-group myResourceGroup --cluster-name myAKSCluster --name labelnp --node-count 1 --labels dept=HR –no-wait
```
En el siguiente ejemplo de salida del comando az aksarc nodepool list se muestra que el grupo de nodos labelnp crea nodos con el nodeLabels especificado.
```
[
  {
    ...
    "count": 1,
    ...
    "name": "labelnp",
    "orchestratorVersion": "1.15.7",
    ...
    "provisioningState": "Creating",
    ...
    "nodeLabels":  {
      "costcenter": "5000",
      "dept": "HR"
    },
    ...
  },
 ...
]
```
Compruebe que las etiquetas se establecieron mediante el kubectl get nodes --show-labels comando :
```
kubectl get nodes --show-labels | grep -e "dept=HR"
```

Actualización de etiquetas en grupos de nodos existentes

Actualice una etiqueta en un grupo de nodos existente mediante el comando az aksarc nodepool update . La actualización de etiquetas en grupos de nodos existentes sobrescribe las etiquetas antiguas con las nuevas etiquetas. Las etiquetas deben ser pares clave-valor y tener una sintaxis válida.
```
az aksarc nodepool update --resource-group myResourceGroup --cluster-name myAKSCluster --name labelnp --labels dept=ACCT costcenter=6000 --no-wait
```
Compruebe que las etiquetas se han establecido con el comando kubectl get nodes --show-labels.
```
kubectl get nodes --show-labels | grep -e "costcenter=6000" -e "dept=ACCT"
```

Etiquetas no disponibles

AKS habilitado por Azure Arc sigue las mismas reglas que AKS:

No se puede cambiar la etiqueta reservada del sistema. Si intenta hacerlo, se devuelve un error.
Los prefijos reservados de Kubernetes y AKS no se pueden usar para ningún nodo.

Para obtener más información, consulte Etiquetas no disponibles en la documentación de AKS.

Pasos siguientes

Para más información sobre las etiquetas de Kubernetes, consulte la documentación de Kubernetes.