Używanie etykiet klastra w usłudze AKS włączonej przez usługę Azure Arc

Dotyczy: Azure Stack HCI, wersja 23H2

Jeśli masz wiele pul węzłów, możesz dodać etykietę podczas tworzenia puli węzłów. Etykiety kubernetes obsługują reguły planowania dla węzłów.

W tym artykule opisano sposób używania etykiet w klastrze Kubernetes w usłudze AKS włączonej przez usługę Arc.

Tworzenie klastra Kubernetes z etykietą

Utwórz klaster Kubernetes z etykietą przy użyciu az aksarc create polecenia i określ --node-labels parametr, aby ustawić etykiety. Etykiety muszą być parą klucz/wartość i mieć prawidłową składnię.
```
az aksarc create --resource-group myResourceGroup --name myAKSCluster --node-count 2 --nodepool-labels dept=IT
```
Sprawdź, czy etykiety zostały ustawione przy użyciu kubectl get nodes --show-labels polecenia :
```
kubectl get nodes --show-labels | grep -e "dept=IT"
```

Utwórz pulę węzłów z etykietą za pomocą az aksarc nodepool add polecenia i określ nazwę --name parametrów i etykiet parametru --labels . Etykiety muszą być parą klucz/wartość i mieć prawidłową składnię.

Poniższy przykład tworzy pulę węzłów o nazwie labelnp z etykietą dept=HR:
```
az aksarc nodepool add –resource-group myResourceGroup –cluster-name myAKSCluster –name labelnp –node-count 1 –labels dept=HR –no-wait
```
Następujące przykładowe dane wyjściowe z az aksarc nodepool list polecenia pokazują, że labelnp pula węzłów tworzy węzły z określoną wartością nodeLabels:
```
[
  {
    ...
    "count": 1,
    ...
    "name": "labelnp",
    "orchestratorVersion": "1.15.7",
    ...
    "provisioningState": "Creating",
    ...
    "nodeLabels":  {
      "costcenter": "5000",
      "dept": "HR"
    },
    ...
  },
 ...
]
```
Sprawdź, czy etykiety zostały ustawione przy użyciu kubectl get nodes --show-labels polecenia :
```
kubectl get nodes --show-labels | grep -e "dept=HR"
```

Zaktualizuj etykietę w istniejącej puli węzłów za pomocą polecenia az aksarc nodepool update . Aktualizowanie etykiet w istniejących pulach węzłów zastępuje stare etykiety nowymi etykietami. Etykiety muszą być parami klucz/wartość i mieć prawidłową składnię.
```
az aksarc nodepool update --resource-group myResourceGroup --cluster-name myAKSCluster --name labelnp --labels dept=ACCT costcenter=6000 --no-wait
```
Sprawdź, czy etykiety zostały ustawione przy użyciu kubectl get nodes --show-labels polecenia .
```
kubectl get nodes --show-labels | grep -e "costcenter=6000" -e "dept=ACCT"
```

Usługa AKS włączona przez usługę Azure Arc jest zgodna z tymi samymi regułami co usługa AKS:

Nie można zmienić etykiety zarezerwowanej systemu. Jeśli spróbujesz to zrobić, zostanie zwrócony błąd.
Nie można używać prefiksów zarezerwowanych platformy Kubernetes i AKS dla żadnego węzła.

Aby uzyskać więcej informacji, zobacz Niedostępne etykiety w dokumentacji usługi AKS.