Clusterbeschriftungen in AKS verwenden, die durch Azure Arc aktiviert werden

2025-04-23

Gilt für: AKS auf Azure Local

Wenn Sie über mehrere Knotenpools verfügen, können Sie während der Erstellung des Knotenpools eine Bezeichnung hinzufügen. Kubernetes-Bezeichnungen behandeln die Planungsregeln für Knoten.

In diesem Artikel wird beschrieben, wie Bezeichnungen in einem Kubernetes-Cluster auf AKS verwendet werden, das durch Arc aktiviert wird.

Erstellen eines Kubernetes-Clusters mit einer Bezeichnung

Erstellen Sie einen Kubernetes-Cluster mit einer Beschriftung mithilfe des az aksarc create Befehls, und geben Sie den --node-labels Parameter an, um Ihre Bezeichnungen festzulegen. Bezeichnungen müssen ein Schlüssel-Wert-Paar sein und über eine gültige Syntax verfügen.
```
az aksarc create --resource-group myResourceGroup --name myAKSCluster --node-count 2 --nodepool-labels dept=IT
```
Stellen Sie sicher, dass die Bezeichnungen mit dem kubectl get nodes --show-labels Befehl festgelegt wurden:
```
kubectl get nodes --show-labels | grep -e "dept=IT"
```

Erstellen eines Knotenpools mit einer Bezeichnung

Erstellen Sie mithilfe des Befehls az aksarc nodepool add einen Knotenpool mit einer Bezeichnung, und geben Sie einen Namen für die --name-Parameter und Bezeichnungen für den --labels-Parameter an. Bezeichnungen müssen ein Schlüssel-Wert-Paar sein und über eine gültige Syntax verfügen.

Im folgenden Beispiel wird ein Knotenpool mit der Bezeichnung labelnp erstellt und mit dem Label dept=HR versehen.
```
az aksarc nodepool add --resource-group myResourceGroup --cluster-name myAKSCluster --name labelnp --node-count 1 --labels dept=HR –no-wait
```
Die folgende Beispielausgabe des az aksarc nodepool list Befehls zeigt, dass der labelnp Knotenpool Knoten mit den angegebenen nodeLabels erstellt.
```
[
  {
    ...
    "count": 1,
    ...
    "name": "labelnp",
    "orchestratorVersion": "1.15.7",
    ...
    "provisioningState": "Creating",
    ...
    "nodeLabels":  {
      "costcenter": "5000",
      "dept": "HR"
    },
    ...
  },
 ...
]
```
Überprüfen Sie, ob die Bezeichnungen mit dem kubectl get nodes --show-labels Befehl festgelegt wurden:
```
kubectl get nodes --show-labels | grep -e "dept=HR"
```

Bezeichnungen für vorhandene Knotenpools aktualisieren

Aktualisieren Sie ein Label in einem vorhandenen Knotenpool mithilfe des Befehls az aksarc nodepool update. Beim Aktualisieren von Bezeichnungen für vorhandene Knotenpools werden die alten Bezeichnungen mit den neuen Bezeichnungen überschrieben. Beschriftungen müssen Schlüssel-Wert-Paare sein und über eine gültige Syntax verfügen.
```
az aksarc nodepool update --resource-group myResourceGroup --cluster-name myAKSCluster --name labelnp --labels dept=ACCT costcenter=6000 --no-wait
```
Überprüfen Sie mithilfe des Befehls kubectl get nodes --show-labels, ob die Bezeichnungen festgelegt wurden.
```
kubectl get nodes --show-labels | grep -e "costcenter=6000" -e "dept=ACCT"
```

Nicht verfügbare Bezeichnungen

AKS, das von Azure Arc ermöglicht wird, folgt den gleichen Regeln wie AKS:

Die reservierte Systembezeichnung kann nicht geändert werden. Wenn Sie versuchen, dies zu tun, wird ein Fehler zurückgegeben.
Die reservierten Präfixe Kubernetes und AKS können für keinen Knoten verwendet werden.

Weitere Informationen finden Sie in der AKS-Dokumentation unter "Nicht verfügbare Bezeichnungen ".

Nächste Schritte

Weitere Informationen zu Kubernetes-Bezeichnungen finden Sie in der Kubernetes-Dokumentation.