Erstellen von Knotenpools für einen Cluster in Azure Kubernetes Service (AKS)

In diesem Artikel erfahren Sie, wie Sie einen oder mehrere Knotenpools in einem AKS-Cluster erstellen.

Hinweis

Dieses Feature ermöglicht mehr Kontrolle über das Erstellen und Verwalten mehrerer Knotenpools und erfordert separate Befehle für Erstellungs-/Aktualisierungs-/Lösch-(CRUD)-Vorgänge. Für über az aks create oder az aks update ausgeführte Clustervorgänge wurde bisher die managedCluster-API verwendet, und diese Vorgänge stellten die einzigen Optionen zum Ändern der Steuerungsebene und eines einzelnen Knotenpools dar. Diese Funktion stellt einen separaten Vorgang für Agent-Pools über die agentPool-API zur Verfügung und erfordert die Verwendung des az aks nodepool-Befehlssatzes zum Ausführen von Vorgängen für einen einzelnen Knotenpool.

Wichtig

Ab November 30, 2025 unterstützt Azure Kubernetes Service (AKS) keine Sicherheitsupdates mehr für Azure Linux 2.0. Das Azure Linux 2.0-Knoten-Image wurde am Release 202512.06.0 eingefroren. Ab dem 31. März 2026 werden Knotenimages entfernt, und Sie können Ihre Knotenpools nicht skalieren. Migrieren Sie zu einer unterstützten Azure Linux-Version, indem Sie Ihre Knotenpools zu einer unterstützten Kubernetes-Version aktualisieren oder zu osSku AzureLinux3 migrieren. Weitere Informationen finden Sie im GitHub-Problem „Außerbetriebnahme“ und in der Ankündigung zur Außerbetriebnahme von Azure-Updates. Um über Ankündigungen und Updates auf dem Laufenden zu bleiben, folgen Sie den AKS-Versionshinweisen.

Voraussetzungen

  • Sie benötigen Azure CLI Version 2.87.0 oder höher installiert und konfiguriert. Führen Sie az --version aus, um die Version zu ermitteln. Informationen zum Installieren oder Aktualisieren finden Sie unter Install Azure CLI.
  • Um eine ARM-Vorlage bereitzustellen, benötigen Sie Schreibzugriff auf die Ressourcen, die Sie bereitstellen und auf alle Vorgänge im ressourcentyp Microsoft.Resources/deployments zugreifen. Um beispielsweise einen virtuellen Computer (VM) bereitzustellen, benötigen Sie Microsoft.Compute/virtualMachines/write und Microsoft.Resources/deployments/* Berechtigungen. Eine Liste der Rollen und Berechtigungen finden Sie unter Azure integrierte Rollen.
  • Überprüfen Sie die folgenden Anforderungen für jeden Parameter:
    • osType: Der Betriebssystemtyp. Der Standardwert ist Linux.
    • osSKU: Gibt die vom Agentpool verwendete Betriebssystem-SKU an.
    • count: Anzahl der Agents (VMs) zum Hosten von Docker-Containern. Zulässige Werte müssen sich im Bereich von 0 bis 1000 (einschließlich) für Benutzerpools und im Bereich von 1 bis 1000 (einschließlich) für Systempools befinden. Der Standardwert ist 1.
  • Nachdem Sie den Cluster mithilfe einer ARM-Vorlage bereitgestellt haben, können Sie Azure CLI oder Azure PowerShell verwenden, um eine Verbindung mit dem Cluster herzustellen und die Beispielanwendung bereitzustellen.

Einschränkungen

Die folgenden Einschränkungen gelten für die Erstellung von AKS-Clustern, die mehrere Knotenpools unterstützen:

  • Sie können den Systemknotenpool löschen, wenn im AKS-Cluster ein anderer Systemknotenpool als Ersatz für diesen vorhanden ist. Andernfalls können Sie den Systemknotenpool nicht löschen.
  • Systempools müssen mindestens zwei Knoten enthalten, während Benutzerknotenpools keine oder mehrere Knoten enthalten können.
  • Wenn Sie einen Cluster mit einem einzelnen Knotenpool erstellen, muss der Betriebssystemtyp sein Linux. Die Betriebssystem-SKU kann eine beliebige Linux-Variante wie Ubuntu, AzureContainerLinux oder AzureLinux sein. Sie können keinen Cluster mit einem einzelnen Windows Knotenpool erstellen. Wenn Sie Windows Container ausführen möchten, müssen Sie dem Cluster nach der Erstellung mit einem Linux-Systemknotenpool einen Windows Knotenpool hinzufügen.
  • Der AKS-Cluster Load Balancer muss die Standard-SKU verwenden, um mehrere Knotenpools zu verwenden. Das Feature wird mit Basic-SKU-Lastenausgleichsmodulen nicht unterstützt.
  • Der AKS-Cluster muss Virtual Machine Scale Sets für die Knoten verwenden.
  • Der Name eines Knotenpools darf nur alphanumerische Zeichen in Kleinbuchstaben enthalten und muss mit einem Kleinbuchstaben beginnen.
    • Bei Linux-Knotenpools muss die Länge zwischen 1 und 12 Zeichen betragen.
    • Bei Windows Knotenpools muss die Länge zwischen 1 und 6 Zeichen betragen.
  • Alle Knotenpools müssen sich im selben virtuellen Netzwerk (VNet) befinden.
  • Sie können die VM-Größe eines Knotenpools nach der Erstellung nicht mehr ändern.
  • Beim Erstellen mehrerer Knotenpools während der Clustererstellung muss die Kubernetes-Version für die Knotenpools der für die Steuerungsebene festgelegten Version entsprechen. Sie können Updates vornehmen, nachdem Sie den Cluster mithilfe von Vorgängen pro Knotenpool bereitgestellt haben.

Wichtig

Wenn Sie Azure Container Linux (ACL) auf AKS verwenden, stellen Sie sicher, dass Sie die folgenden Überlegungen und Einschränkungen überprüfen:

Erstellen spezialisierter Knotenpools

Informationen zum Erstellen spezieller Knotenpools finden Sie in den folgenden Artikeln:

Festlegen von Umgebungsvariablen

Legen Sie die folgenden Umgebungsvariablen in Ihrer Shell fest, um die Befehle in diesem Artikel zu vereinfachen. Sie können die Werte zu Ihren bevorzugten Bezeichnungen anpassen.

export RESOURCE_GROUP_NAME="my-aks-rg"
export LOCATION="eastus"
export CLUSTER_NAME="my-aks-cluster"
export NODE_POOL_NAME="mynodepool"

Erstellen einer Ressourcengruppe

Erstellen Sie eine Azure Ressourcengruppe mithilfe des Befehls az group create.

az group create --name $RESOURCE_GROUP_NAME --location $LOCATION

Erstellen eines AKS-Clusters mit einem einzelnen Knotenpool mithilfe des Azure CLI

Wenn Sie nur einen Knotenpool in Ihrem AKS-Cluster wünschen, können Sie Anwendungspods in Systemknotenpools planen. Wenn Sie für Ihren AKS-Cluster nur einen Systemknotenpool in einer Produktionsumgebung ausführen, sollten Sie für den Knotenpool mindestens drei Knoten verwenden. Wenn ein Knoten herunterfährt, wird die Redundanz kompromittiert. Sie können dieses Risiko verringern, indem Sie mehr Knoten im Systemknotenpool haben.

  1. Erstellen Sie einen Cluster mit einem einzelnen Ubuntu-Knotenpool mithilfe des az aks create Befehls. In diesem Schritt werden zwei Knoten im einzelnen Knotenpool angegeben.

    az aks create \
    --resource-group $RESOURCE_GROUP_NAME \
    --name $CLUSTER_NAME \
    --vm-set-type VirtualMachineScaleSets \
    --node-count 2 \
    --os-sku Ubuntu \
    --location $LOCATION \
    --load-balancer-sku standard \
    --generate-ssh-keys

    Die Erstellung des Clusters dauert einige Minuten.

  2. Wenn der Cluster bereit ist, rufen Sie die Clusteranmeldeinformationen mithilfe des Befehls az aks get-credentials ab.

    az aks get-credentials --resource-group $RESOURCE_GROUP_NAME --name $CLUSTER_NAME

Hinzufügen eines zweiten Knotenpools mithilfe der Azure CLI

Der im vorherigen Abschnitt erstellte Cluster verfügt über einen einzelnen Knotenpool. In diesem Abschnitt fügen wir dem Cluster einen zweiten Knotenpool hinzu. Dieser zweite Knotenpool kann einen Betriebssystemtyp von Linux mit einer Betriebssystem-SKU von Ubuntu oder AzureLinux oder einem Betriebssystemtyp von Windows haben.

Hinweis

Wenn Sie einen Knotenpool hinzufügen möchten, der ephemerale Betriebssystemdatenträger zu Ihrem AKS-Cluster verwendet, können Sie das --node-osdisk-type Flag auf Ephemeral festlegen, wenn der az aks nodepool add Befehl ausgeführt wird.

Mit einem kurzlebigen Betriebssystem können Sie VMs und Instanzimages bis zur Größe des VM-Caches bereitstellen. Die Betriebssystemdatenträgerkonfiguration des Standardknotens in AKS verwendet 128 GB, was bedeutet, dass Sie eine VM-Größe benötigen, deren Cache größer als 128 GB ist. Der Standardwert Standard_DS2_v2 hat eine Cachegröße von 86 GB, was nicht ausreicht. Die Standard_DS3_v2 VM-SKU hat eine Cachegröße von 172 GB, die groß genug ist. Sie können auch die Standardgröße des Betriebssystemdatenträgers mit --node-osdisk-size verringern, sollten jedoch beachten, dass die Mindestgröße für AKS-Images 30 GB beträgt.

Wenn Sie Knotenpools mit netzwerkgebundenen Betriebssystemdatenträgernerstellen möchten, können Sie das Flag --node-osdisk-type beim Ausführen des Befehls Managed auf az aks nodepool add festlegen.

Hinzufügen eines Linux-Knotenpools

Erstellen Sie einen neuen Knotenpool mit dem Befehl az aks nodepool add. Im folgenden Beispiel wird ein Linux Knotenpool mit der Ubuntu Betriebssystem-SKU erstellt, die mit drei Knoten ausgestattet ist. Wenn Sie keine Betriebssystem-SKU angeben, setzt AKS standardmäßig auf Ubuntu.

az aks nodepool add \
    --resource-group $RESOURCE_GROUP_NAME \
    --cluster-name $CLUSTER_NAME \
    --name $NODE_POOL_NAME \
    --node-vm-size Standard_DS2_v2 \
    --os-type Linux \
    --os-sku Ubuntu \
    --node-count 3

Es dauert ein paar Minuten, um den Knotenpool zu erstellen.

Hinzufügen eines Windows Server Knotenpools

Erstellen des Windows Server 2025-Knotenpools

Erstellen Sie einen neuen Knotenpool mit dem Befehl az aks nodepool add. Im folgenden Beispiel wird ein Windows Knotenpool mit der Windows2025 Betriebssystem-SKU erstellt, die mit drei Knoten ausgestattet ist.

Weitere Informationen zu Windows Betriebssystem finden Sie unter Windows bewährte Methoden.

az aks nodepool add \
    --resource-group $RESOURCE_GROUP_NAME \
    --cluster-name $CLUSTER_NAME \
    --name $NODE_POOL_NAME \
    --node-vm-size Standard_DS2_v2 \
    --os-type Windows \
    --os-sku Windows2025 \
    --node-count 3

Überprüfen des Status Ihrer Knotenpools

Überprüfen Sie den Status Ihrer Knotenpools mit dem Befehl az aks nodepool list, und geben Sie Ihre Ressourcengruppe und den Clusternamen an.

az aks nodepool list --resource-group $RESOURCE_GROUP_NAME --cluster-name $CLUSTER_NAME

Erstellen eines AKS-Clusters mit einem einzelnen Knotenpool mithilfe einer ARM-Vorlage

Wenn Sie nur einen Knotenpool in Ihrem AKS-Cluster wünschen, können Sie Anwendungspods in Systemknotenpools planen. Wenn Sie für Ihren AKS-Cluster nur einen Systemknotenpool in einer Produktionsumgebung ausführen, sollten Sie für den Knotenpool mindestens drei Knoten verwenden. Wenn ein Knoten herunterfährt, wird die Redundanz kompromittiert. Sie können dieses Risiko verringern, indem Sie mehr Knoten im Systemknotenpool haben.

Erstellen einer Microsoft.ContainerService/managedClusters-Ressource

Erstellen Sie eine Microsoft.ContainerService/managedClusters-Ressource, indem Sie ihrer Vorlage dieses JSON hinzufügen.

  • Erstellen Sie einen einzelnen Ubuntu-Knotenpool in Ihrem AKS-Cluster, indem Sie die folgenden Änderungen an Ihrer ARM-Vorlage vornehmen:

      "properties": {
    "agentPoolProfiles": [
    {
        "count": "1",
        "osSKU": "ubuntu",
        "osType": "linux"
     } 
     ],
}

Hinzufügen eines zweiten Knotenpools mithilfe einer ARM-Vorlage

Der im vorherigen Abschnitt erstellte Cluster verfügt über einen einzelnen Knotenpool. In diesem Abschnitt fügen wir dem Cluster einen zweiten Knotenpool hinzu. Dieser zweite Knotenpool kann einen Betriebssystemtyp von Linux mit einer Betriebssystem-SKU von Ubuntu oder AzureLinux oder einem Betriebssystemtyp von Windows haben.

Hinzufügen von Linux-Knotenpools

  • Erstellen Sie mehrere Ubuntu-Knotenpools in Ihrem AKS-Cluster, indem Sie die folgenden Änderungen an Ihrer ARM-Vorlage vornehmen:

      "properties": {
    "agentPoolProfiles": [
    {
        "count": "3",
        "osSKU": "ubuntu",
        "osType": "linux"
     } 
     ],
}

Hinzufügen von Windows Server-Knotenpools

Erstellen der Windows Server 2025-Knotenpools

  • Erstellen Sie mehrere Windows Knotenpools in Ihrem AKS-Cluster, indem Sie die folgenden Änderungen an Ihrer ARM-Vorlage vornehmen:

      "properties": {
    "agentPoolProfiles": [
    {
        "count": "3",
        "osSKU": "windows2025",
        "osType": "windows"
     } 
     ],
}

Stellen Sie Ihre ARM-Vorlage bereit

Taints, Bezeichnungen oder Tags für einen Knoten-Pool festlegen

Beim Erstellen eines Knotenpools können Sie ihm Taints, Bezeichnungen oder Tags hinzufügen. Wenn Sie einen Taint, eine Bezeichnung oder ein Tag hinzufügen, erhalten alle Knoten innerhalb dieses Knotenpools ebenfalls diesen Taint, diese Bezeichnung oder dieses Tag. Es wird empfohlen, diese Eigenschaften auf einen gesamten Knotenpool anstelle einzelner Knoten anzuwenden. Auf diese Weise können Sie die Eigenschaften aller Knoten im Knotenpool ganz einfach verwalten, indem Sie die Eigenschaften des Knotenpools aktualisieren, anstatt jeden Knoten einzeln zu aktualisieren.

Verwenden Sie die folgenden Ressourcen, um spezifische Anweisungen zum Festlegen von Taints, Labels oder Tags für einen Knotenpool zu erhalten.

Nächste Schritte

In diesem Artikel haben Sie erfahren, wie Sie einen AKS-Cluster mit einem einzelnen Knotenpool erstellen und Ihrem Cluster zusätzliche Knotenpools hinzufügen. Weitere Informationen zum Verwalten Ihrer Knotenpools finden Sie in den folgenden Artikeln:

  • Last updated on