Verwenden von Clusterbeschriftungen in AKS, die von Azure Arc aktiviert sind

Artikel
11/23/2024

Gilt für: Azure Local, Version 23H2

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, die von Arc aktiviert sind.

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 dept=HRerstelltlabelnp:
```
az aksarc nodepool add --resource-group myResourceGroup --cluster-name myAKSCluster --name labelnp --node-count 1 --labels dept=HR –no-wait
```
Die folgende Beispielausgabe aus dem az aksarc nodepool list Befehl zeigt, dass der labelnp Knotenpool Knoten mit dem angegebenen :nodeLabels
```
[
  {
    ...
    "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"
```

Aktualisieren von Bezeichnungen in vorhandenen Knotenpools

Aktualisieren Sie eine Bezeichnung in einem vorhandenen Knotenpool mithilfe des Befehls "az aksarc nodepool aktualisieren ". 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, die von Azure Arc aktiviert sind, folgt den gleichen Regeln wie AKS:

Sie können die reservierte Systembezeichnung nicht ändern. 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.

Freigeben über