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

Article
06/01/2024

S’applique à : Azure Stack HCI, 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 aks 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 az aksarc nodepool list commande montre que le labelnp pool de nœuds crée des nœuds avec le 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 les étiquettes sur les 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 qu’AKS :

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

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

Étapes suivantes

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

Partager via