Utiliser des étiquettes de cluster dans AKS activées par Azure Arc

Article
11/23/2024

S’applique à : Azure Local, version 23H2

Si vous avez plusieurs pools de nœuds, vous pouvez ajouter une étiquette lors de la création du pool de nœuds. Les étiquettes Kubernetes gèrent les règles de planification pour les nœuds.

Cet article explique comment utiliser des étiquettes dans un cluster Kubernetes sur AKS activé par Arc.

Créer un cluster Kubernetes avec une étiquette

Créez un cluster Kubernetes avec une étiquette à l’aide de la az aksarc create commande et spécifiez le --node-labels paramètre pour définir vos étiquettes. Les étiquettes doivent être une paire clé/valeur et avoir une syntaxe valide.
```
az aksarc create --resource-group myResourceGroup --name myAKSCluster --node-count 2 --nodepool-labels dept=IT
```
Vérifiez que les étiquettes ont été définies à l’aide de la kubectl get nodes --show-labels commande :
```
kubectl get nodes --show-labels | grep -e "dept=IT"
```

Créer un pool de nœuds avec une étiquette

Créez un pool de nœuds avec une étiquette à l’aide de la commande az aksarc nodepool add et spécifiez un nom pour le paramètre --name et des étiquettes pour le paramètre --labels. Les étiquettes doivent être une paire clé/valeur et avoir une syntaxe valide.

L’exemple suivant crée un pool de nœuds nommé labelnp avec l’étiquette dept=HR:
```
az aksarc nodepool add --resource-group myResourceGroup --cluster-name myAKSCluster --name labelnp --node-count 1 --labels dept=HR –no-wait
```
L’exemple de sortie suivant de la commande montre que le az aksarc nodepool list labelnp pool de nœuds crée des nœuds avec le code spécifié nodeLabels:
```
[
  {
    ...
    "count": 1,
    ...
    "name": "labelnp",
    "orchestratorVersion": "1.15.7",
    ...
    "provisioningState": "Creating",
    ...
    "nodeLabels":  {
      "costcenter": "5000",
      "dept": "HR"
    },
    ...
  },
 ...
]
```
Vérifiez que les étiquettes ont été définies à l’aide de la kubectl get nodes --show-labels commande :
```
kubectl get nodes --show-labels | grep -e "dept=HR"
```

Mettre à jour des étiquettes sur des pools de nœuds existants

Mettez à jour une étiquette sur un pool de nœuds existant à l’aide de la commande az aksarc nodepool update . La mise à jour d’étiquettes sur des pools de nœuds existants remplace les anciennes étiquettes par de nouvelles. Les étiquettes doivent être des paires clé/valeur et avoir une syntaxe valide.
```
az aksarc nodepool update --resource-group myResourceGroup --cluster-name myAKSCluster --name labelnp --labels dept=ACCT costcenter=6000 --no-wait
```
Vérifiez que les étiquettes ont été définies à l’aide de la commande kubectl get nodes --show-labels.
```
kubectl get nodes --show-labels | grep -e "costcenter=6000" -e "dept=ACCT"
```

Étiquettes non disponibles

AKS activé par Azure Arc suit les mêmes règles que AKS :

Vous ne pouvez pas modifier l’étiquette système réservée. Si vous tentez de le faire, une erreur est retournée.
Les préfixes réservés Kubernetes et AKS ne peuvent pas être utilisés pour un nœud.

Pour plus d’informations, consultez les étiquettes non disponibles dans la documentation AKS.

Étapes suivantes

Pour plus d’informations sur les étiquettes Kubernetes, consultez la documentation Kubernetes.

Partager via