Aktualisierung der Azure Kubernetes Service (AKS)-Knoten-Images

Bereitstellen und Erkunden

Azure Kubernetes Service (AKS) regelmäßig neue Knotenimages bereitstellt, aktualisieren Sie daher ihre Knotenimages häufig, um die neuesten AKS-Features zu verwenden. Linux-Knotenimages werden wöchentlich aktualisiert, und Windows Knotenimages werden monatlich aktualisiert. Die AKS-Versionshinweise umfassen Ankündigungen zum Imageupgrade. Es kann bis zu zwei Wochen dauern, bis diese Updates in allen Regionen bereitgestellt werden. Sehen Sie sich den Versionsverfolgungs-Tracker für den Rolloutstatus an. Sie können Knotenimageupgrades auch automatisch durchführen und sie mithilfe geplanter Wartung planen. Weitere Informationen finden Sie unter "Automatisches Upgrade von Betriebssystemimages".

AKS empfiehlt Knoten-Kanäle für das automatische Upgrade des Betriebssystems, wodurch automatisch Ihre Knotenimages aktualisiert oder Sicherheitspatches während der Wartungsfenster angewendet werden, ohne die Kubernetes-Version zu ändern. Wenn Sie Ihre Knotenimages manuell aktualisieren möchten, befolgen Sie die Anweisungen in diesem Artikel. In diesem Artikel erfahren Sie, wie Sie ein Upgrade für AKS-Clusterknotenimages durchführen und Knotenpoolimages aktualisieren, ohne ein Upgrade der Kubernetes-Version durchzuführen. Informationen zum Upgrade der Kubernetes-Version für Ihren Cluster finden Sie unter Aktualisieren eines AKS-Clusters.

Important

Ab dem 30. November 2025 unterstützt Azure Kubernetes Service (AKS) keine Sicherheitsupdates für Azure Linux 2.0 mehr oder stellt diese bereit. Das Azure Linux 2.0-Knotenimage ist eingefroren bei der Version 202512.06.0. 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-Issue "Retirement" und in der Ankündigung zur Außerdienststellung von Azure Updates. Um über Ankündigungen und Updates auf dem Laufenden zu bleiben, folgen Sie den AKS-Release-Notes.

Hinweis

Cluster, die Node Auto-Provisioning (NAP) verwenden, aktualisieren Knotenimages automatisch, wenn ein neues Image verfügbar ist. Sie können ein Wartungsfenster konfigurieren, um zu steuern, wann NAP ein neues Image einnimmt, aber das Fenster bestimmt nicht unbedingt, wann vorhandene Knoten unterbrochen werden. Die Driftlogik von NAP, Karpenter Node Disruption Budgets und Pod Disruption Budgets steuern, wie und wann Unterbrechungen auftreten. Weitere Informationen finden Sie unter Node Image Updates für NAP.

Sie können kein Downgrade einer Knotenbildversion durchführen (z. B. AKSUbuntu-2404 zu AKSUbuntu-2204 oder AKSUbuntu-2404-202601.27.0 auf AKSUbuntu-2404-202601.13.0).

Voraussetzungen

  • Ein vorhandener AKS-Cluster und Knotenpool.
  • Die Azure CLI installiert und bei Ihrem Azure Konto angemeldet.
  • Berechtigung zum Abrufen von Clusteranmeldeinformationen und Lesen und Aktualisieren der AKS-Cluster- und Knotenpools.
  • Eine Bash-Shell. Die Befehle in diesem Artikel verwenden die Syntax der Bash-Umgebungsvariablen.

Legen Sie Umgebungsvariablen für die Namen der Ressourcengruppe, des Clusters und des Knotenpools fest, die in den folgenden Befehlen verwendet werden sollen:

export AKS_RESOURCE_GROUP="<resource-group-name>"
export AKS_CLUSTER="<cluster-name>"
export AKS_NODEPOOL="<node-pool-name>"

Verbinden Sie sich mit Ihrem AKS-Cluster

  1. Stellen Sie mithilfe des Befehls az aks get-credentials eine Verbindung mit Ihrem AKS-Cluster her.

    az aks get-credentials \
    --resource-group $AKS_RESOURCE_GROUP \
    --name $AKS_CLUSTER

Prüfen Sie auf verfügbare Knoten-Bild-Upgrades

  1. Suchen Sie mithilfe des az aks nodepool get-upgrades-Befehls nach verfügbaren Knoten-Image-Upgrades.

    az aks nodepool get-upgrades \
    --nodepool-name $AKS_NODEPOOL \
    --cluster-name $AKS_CLUSTER \
    --resource-group $AKS_RESOURCE_GROUP

  2. Suchen Sie in der Ausgabe den latestNodeImageVersion-Wert, und notieren Sie ihn. Dieser Wert ist die neueste Version des Knotenimages, die für den Knotenpool verfügbar ist.

  3. Überprüfen Sie die aktuelle Knotenimageversion, um sie mithilfe des az aks nodepool show-Befehls mit der aktuellen Version zu vergleichen.

    az aks nodepool show \
    --resource-group $AKS_RESOURCE_GROUP \
    --cluster-name $AKS_CLUSTER \
    --name $AKS_NODEPOOL \
    --query nodeImageVersion

  4. Wenn sich der nodeImageVersion-Wert von latestNodeImageVersion unterscheidet, können Sie das Knotenimage upgraden.

Alle Knotenimages in allen Knotenpools aktualisieren

  1. Aktualisieren Sie alle Knotenbilder in allen Knotenpools in Ihrem Cluster mithilfe des Befehls az aks upgrade mit dem --node-image-only-Schalter.

    az aks upgrade \
    --resource-group $AKS_RESOURCE_GROUP \
    --name $AKS_CLUSTER \
    --node-image-only \
    --yes

  2. Sie können die Status der Knotenimages mithilfe des kubectl get nodes-Befehls überprüfen.

    Hinweis

    Dieser Befehl kann sich abhängig von der verwendeten Shell geringfügig unterscheiden. Weitere Informationen zu Windows- und PowerShell-Umgebungen finden Sie in der Dokumentation Kubernetes JSONPath. Dieser Befehl listet den Namen jedes Knotens zusammen mit dem Wert seiner kubernetes.azure.com/node-image-version Bezeichnung auf, der die aktuelle Imageversion des Knotens identifiziert.

    kubectl get nodes -o jsonpath='{range .items[*]}{.metadata.name}{"\t"}{.metadata.labels.kubernetes\.azure\.com\/node-image-version}{"\n"}{end}'

  3. Wenn das Upgrade beendet ist, verwenden Sie den az aks show-Befehl, um die aktualisierten Details zum Knotenpool abzurufen. Das aktuelle Knotenimage wird in der nodeImageVersion-Eigenschaft angezeigt.

    az aks show \
    --resource-group $AKS_RESOURCE_GROUP \
    --name $AKS_CLUSTER  \
    --query "agentPoolProfiles[].{Name:name, NodeImageVersion:nodeImageVersion}"

Aktualisieren eines bestimmten Knotenpools

  1. Aktualisieren Sie das Betriebssystemimage eines Knotenpools, ohne ein Upgrade des Kubernetes-Clusters durchzuführen, mit dem az aks nodepool upgrade-Befehl mit dem --node-image-only-Flag.

    az aks nodepool upgrade \
    --resource-group $AKS_RESOURCE_GROUP \
    --cluster-name $AKS_CLUSTER \
    --name $AKS_NODEPOOL \
    --node-image-only

  2. Sie können die Status der Knotenimages mit dem kubectl get nodes-Befehls überprüfen.

    Hinweis

    Dieser Befehl kann sich abhängig von der verwendeten Shell geringfügig unterscheiden. Weitere Informationen zu Windows- und PowerShell-Umgebungen finden Sie in der Dokumentation Kubernetes JSONPath. Dieser Befehl listet den Namen jedes Knotens zusammen mit dem Wert seiner kubernetes.azure.com/node-image-version Bezeichnung auf, der die aktuelle Imageversion des Knotens identifiziert.

    kubectl get nodes -o jsonpath='{range .items[*]}{.metadata.name}{"\t"}{.metadata.labels.kubernetes\.azure\.com\/node-image-version}{"\n"}{end}'

  3. Wenn das Upgrade beendet ist, verwenden Sie den az aks nodepool show-Befehl, um die aktualisierten Details zum Knotenpool abzurufen. Das aktuelle Knotenimage wird in der nodeImageVersion-Eigenschaft angezeigt.

    az aks nodepool show \
    --resource-group $AKS_RESOURCE_GROUP \
    --cluster-name $AKS_CLUSTER \
    --name $AKS_NODEPOOL \
    --query nodeImageVersion

Aktualisieren von Knotenimages mit Knotenanstiegen

Dieses Verfahren aktualisiert das Knotenimage für einen bestimmten Knotenpool, nicht alle Knotenpools im Cluster. Standardmäßig verwendet AKS einen zusätzlichen Knoten, um Upgrades zu konfigurieren. Um den Upgradevorgang des Knotenimages zu beschleunigen, aktualisieren Sie Ihre Knotenimages mithilfe eines anpassbaren Knotenaufststwerts.

  1. Konfigurieren Sie die Anzahl der Aufststknoten für den Knotenpool mithilfe des az aks nodepool update Befehls mit der --max-surge Kennzeichnung. Diese Einstellung wird für nachfolgende Upgrades beibehalten.

    Hinweis

    Weitere Informationen zu den Kompromissen verschiedener --max-surge-Einstellungen finden Sie unter Anpassen der Knoten-Surge-Aktualisierung.

    az aks nodepool update \
    --resource-group $AKS_RESOURCE_GROUP \
    --cluster-name $AKS_CLUSTER \
    --name $AKS_NODEPOOL \
    --max-surge 33%

  2. Aktualisieren Sie das Knotenbild mithilfe des az aks nodepool upgrade Befehls mit der --node-image-only Kennzeichnung.

    az aks nodepool upgrade \
    --resource-group $AKS_RESOURCE_GROUP \
    --cluster-name $AKS_CLUSTER \
    --name $AKS_NODEPOOL \
    --node-image-only

  3. Sie können die Status der Knotenimages mit dem kubectl get nodes-Befehls überprüfen. Dieser Befehl listet den Namen jedes Knotens zusammen mit dem Wert seiner kubernetes.azure.com/node-image-version Bezeichnung auf, der die aktuelle Imageversion des Knotens identifiziert.

    kubectl get nodes -o jsonpath='{range .items[*]}{.metadata.name}{"\t"}{.metadata.labels.kubernetes\.azure\.com\/node-image-version}{"\n"}{end}'

  4. Rufen Sie die aktualisierten Knotenpooldetails mithilfe des az aks nodepool show Befehls ab. Das aktuelle Knotenimage wird in der nodeImageVersion-Eigenschaft angezeigt.

    az aks nodepool show \
    --resource-group $AKS_RESOURCE_GROUP \
    --cluster-name $AKS_CLUSTER \
    --name $AKS_NODEPOOL \
    --query nodeImageVersion

Verwandte Inhalte

  • Last updated on