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

Artikel
08/01/2024

Gilt für: Azure Stack HCI, 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 Sie Bezeichnungen in einem Kubernetes-Cluster auf AKS verwenden, die von Arc aktiviert sind.

Erstellen eines Kubernetes-Clusters mit einer Bezeichnung

Erstellen Sie mithilfe des az aksarc create Befehls einen Kubernetes-Cluster mit einer Bezeichnung, 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
```
Vergewissern Sie sich, 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 labelnp Bezeichnung dept=HRerstellt:
```
az aksarc nodepool add –resource-group myResourceGroup –cluster-name myAKSCluster –name labelnp –node-count 1 –labels dept=HR –no-wait
```
Die folgende Beispielausgabe des Befehls zeigt, az aksarc nodepool list dass der labelnp Knotenpool Knoten mit dem angegebenen nodeLabelserstellt:
```
[
  {
    ...
    "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 für vorhandene Knotenpools

Aktualisieren Sie eine Bezeichnung für einen 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. Bezeichnungen 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 wird, folgt den gleichen Regeln wie AKS:

Sie können die Bezeichnung des reservierten Systems nicht ändern. Wenn Sie dies versuchen, wird ein Fehler zurückgegeben.
Die reservierten Kubernetes- und AKS-Präfixe können für keinen Knoten verwendet werden.

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

Nächste Schritte

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

Freigeben über