Använda klusteretiketter i AKS som aktiverats av Azure Arc

Gäller för: Azure Local, version 23H2

Om du har flera nodpooler kanske du vill lägga till en etikett när nodpoolen skapas. Kubernetes-etiketter hanterar schemaläggningsreglerna för noder.

Den här artikeln beskriver hur du använder etiketter i ett Kubernetes-kluster på AKS som aktiveras av Arc.

Skapa ett Kubernetes-kluster med en etikett

Skapa ett Kubernetes-kluster med en etikett med hjälp av az aksarc create kommandot och ange parametern --node-labels för att ange dina etiketter. Etiketter måste vara ett nyckel/värde-par och ha giltig syntax.
```
az aksarc create --resource-group myResourceGroup --name myAKSCluster --node-count 2 --nodepool-labels dept=IT
```
Kontrollera att etiketterna har angetts med kommandot kubectl get nodes --show-labels :
```
kubectl get nodes --show-labels | grep -e "dept=IT"
```

Skapa en nodpool med en etikett med kommandot az aksarc nodepool add och ange ett namn för parametrarna --name och etiketterna för parametern --labels . Etiketter måste vara ett nyckel/värde-par och ha giltig syntax.

I följande exempel skapas en nodpool med namnet labelnp med etiketten dept=HR:
```
az aksarc nodepool add --resource-group myResourceGroup --cluster-name myAKSCluster --name labelnp --node-count 1 --labels dept=HR –no-wait
```
Följande exempelutdata från az aksarc nodepool list kommandot visar att nodpoolen labelnp skapar noder med angivet nodeLabels:
```
[
  {
    ...
    "count": 1,
    ...
    "name": "labelnp",
    "orchestratorVersion": "1.15.7",
    ...
    "provisioningState": "Creating",
    ...
    "nodeLabels":  {
      "costcenter": "5000",
      "dept": "HR"
    },
    ...
  },
 ...
]
```
Kontrollera att etiketterna har angetts med kommandot kubectl get nodes --show-labels :
```
kubectl get nodes --show-labels | grep -e "dept=HR"
```

Uppdatera en etikett i en befintlig nodpool med kommandot az aksarc nodepool update . Om du uppdaterar etiketter i befintliga nodpooler skrivs de gamla etiketterna över med de nya etiketterna. Etiketter måste vara nyckel/värde-par och ha en giltig syntax.
```
az aksarc nodepool update --resource-group myResourceGroup --cluster-name myAKSCluster --name labelnp --labels dept=ACCT costcenter=6000 --no-wait
```
Kontrollera att etiketterna har angetts med kommandot kubectl get nodes --show-labels .
```
kubectl get nodes --show-labels | grep -e "costcenter=6000" -e "dept=ACCT"
```

AKS som aktiveras av Azure Arc följer samma regler som AKS:

Du kan inte ändra den reserverade systemetiketten. Om du försöker göra det returneras ett fel.
De reserverade Kubernetes- och AKS-prefixen kan inte användas för någon nod.

Mer information finns i Otillgängliga etiketter i AKS-dokumentationen.

Mer information om Kubernetes-etiketter finns i Kubernetes-dokumentationen.