Usare le etichette del cluster nel servizio Azure Kubernetes abilitato da Azure Arc

2025-04-17

Si applica a: AKS locale su Azure

Se sono presenti più pool di nodi, potrebbe essere necessario aggiungere un'etichetta durante la creazione del pool di nodi. Le etichette Kubernetes gestiscono le regole di pianificazione per i nodi.

Questo articolo descrive come usare le etichette in un cluster Kubernetes nel servizio Azure Kubernetes abilitato da Arc.

Creare un cluster Kubernetes con un'etichetta

Creare un cluster Kubernetes con un'etichetta usando il az aksarc create comando e specificare il --node-labels parametro per impostare le etichette. Le etichette devono essere una coppia chiave/valore e avere una sintassi valida.
```
az aksarc create --resource-group myResourceGroup --name myAKSCluster --node-count 2 --nodepool-labels dept=IT
```
Verificare che le etichette siano state impostate usando il kubectl get nodes --show-labels comando :
```
kubectl get nodes --show-labels | grep -e "dept=IT"
```

Creare un pool di nodi con un'etichetta

Creare un pool di nodi con un'etichetta usando il az aksarc nodepool add comando e specificare un nome per i --name parametri e le etichette per il --labels parametro. Le etichette devono essere una coppia chiave/valore e avere una sintassi valida.

L'esempio seguente crea un pool di nodi denominato labelnp con l'etichetta dept=HR:
```
az aksarc nodepool add --resource-group myResourceGroup --cluster-name myAKSCluster --name labelnp --node-count 1 --labels dept=HR –no-wait
```
L'output di esempio del seguente comando az aksarc nodepool list mostra che il pool di nodi labelnp crea nodi con il parametro specificato nodeLabels.
```
[
  {
    ...
    "count": 1,
    ...
    "name": "labelnp",
    "orchestratorVersion": "1.15.7",
    ...
    "provisioningState": "Creating",
    ...
    "nodeLabels":  {
      "costcenter": "5000",
      "dept": "HR"
    },
    ...
  },
 ...
]
```
Verificare che le etichette siano state impostate usando il kubectl get nodes --show-labels comando :
```
kubectl get nodes --show-labels | grep -e "dept=HR"
```

Aggiornare le etichette nei pool di nodi esistenti

Aggiornare un'etichetta in un pool di nodi esistente usando il comando az aksarc nodepool update . L'aggiornamento delle etichette nei pool di nodi esistenti sovrascrive le etichette precedenti con le nuove etichette. Le etichette devono essere coppie chiave/valore e avere una sintassi valida.
```
az aksarc nodepool update --resource-group myResourceGroup --cluster-name myAKSCluster --name labelnp --labels dept=ACCT costcenter=6000 --no-wait
```
Verificare che le etichette siano state impostate usando il kubectl get nodes --show-labels comando.
```
kubectl get nodes --show-labels | grep -e "costcenter=6000" -e "dept=ACCT"
```

Etichette non disponibili

Il servizio Azure Kubernetes abilitato da Azure Arc segue le stesse regole del servizio Azure Kubernetes:

Non è possibile modificare l'etichetta di sistema riservata. Se si tenta di eseguire questa operazione, viene restituito un errore.
I prefissi riservati di Kubernetes e AKS non possono essere usati per alcun nodo.

Per ulteriori informazioni, vedere Etichette non disponibili nella documentazione di AKS.

Passaggi successivi

Per altre informazioni sulle etichette kubernetes, vedere la documentazione di Kubernetes.