Konfigurieren von Upgrades für Azure Kubernetes Application Network-Mitglieder (Vorschau)

Von Bedeutung

AKS-Vorschaufunktionen sind auf Selbstbedienungsbasis und freiwillig verfügbar. Vorschauversionen werden „im Istzustand“ und „wie verfügbar“ bereitgestellt und sind von den Service Level Agreements und der eingeschränkten Garantie ausgeschlossen. AKS-Vorschauversionen werden teilweise vom Kundensupport auf Grundlage der bestmöglichen Leistung abgedeckt. Daher sind diese Funktionen nicht für die Verwendung in der Produktion vorgesehen. Weitere Informationen finden Sie in den folgenden Supportartikeln:

Das Azure Kubernetes-Anwendungsnetzwerk bietet flexible Kontrolle darüber, wie Nebenversionsupgrades auf Mitglieder angewendet werden. Jeder Mitgliedscluster, der in einer Azure Kubernetes-Anwendungsnetzwerkressource registriert ist, kann einen von zwei Upgrademodi verwenden, je nachdem, welche Steuerungsebene Sie benötigen: selbstverwaltet (SelfManaged) oder vollständig verwaltet (FullyManaged). Diese Modi funktionieren auf Memberebene, sodass Sie auswählen können, ob Upgrades manuell oder automatisch für jeden Cluster ausgeführt werden.

In diesem Artikel werden die Unterschiede zwischen diesen Upgrademodi erläutert, wie Sie sie für Ihre Azure Kubernetes-Anwendungsnetzwerkmitglieder konfigurieren, und wichtige Überlegungen, die Sie beim Verwalten von Upgrades berücksichtigen sollten.

Allgemeine Überlegungen zum Upgrademodus

Beachten Sie die folgenden Einschränkungen und Überlegungen beim Konfigurieren von Upgrademodi für Azure Kubernetes Application Network-Mitglieder:

  • Azure Kubernetes Application Network-Upgrademodi gelten nur für Nebenversionen von Azure Kubernetes Application Network-Komponenten. Sie steuern oder wirken sich nicht auf Upgrades auf Clusterebene aus, z. B. Kubernetes-Versionen oder Knotenimageupdates.
  • Patchupdates werden unabhängig vom Modus immer automatisch angewendet.
  • Sie wählen den Upgrademodus für jedes Mitglied während des Beitrittsvorgangs aus. Nach der Auswahl bleibt der Modus für dieses Element wirksam, bis er aus der Azure Kubernetes-Anwendungsnetzwerkressource entfernt wird. Sie können den Upgrademodus für ein Mitglied nicht ändern, ohne es zuerst zu entfernen und es erneut der Azure Kubernetes-Anwendungsnetzwerkressource beitreten zu lassen.
  • Wenn Sie während des Mitgliedsbeitritts keinen Aktualisierungsmodus angeben, wird er standardmäßig auf SelfManaged gesetzt.

Selbstverwalteter Modus

Im SelfManaged Modus geben Sie die Nebenversion des Azure Kubernetes-Anwendungsnetzwerks an, um zu installieren und zu steuern, wann Upgrades auftreten. Dieser Modus ist für Szenarien vorgesehen, in denen Sie den kleineren Upgradeprozess manuell verwalten möchten, anstatt sich auf automatisierte Updates zu verlassen. Wenn in diesem Modus --version nicht angegeben ist, wird standardmäßig die N-1-te verfügbare Version verwendet. Dieser Modus ist auch die Standardeinstellung, wenn während des Mitgliedsbeitritts kein Upgrademodus angegeben wird.

Überlegungen zum selbstverwalteten Modus

Beachten Sie bei der Verwendung des SelfManaged Modus die folgenden Überlegungen:

  • Upgrades sind nur zwischen aufeinander folgenden Nebenversionen zulässig (z. B. von Nebenversion N auf N+1). Das Überspringen von Versionen (z. B. das Upgrade von 1.1 zu 1.3) wird nicht unterstützt.
  • Sie können nur einen Rollback auf die unmittelbar vorangehende Version (N-1) ausführen, vorausgesetzt, sie wurde zuvor auf demselben Cluster installiert. Das Zurücksetzen auf eine andere frühere Version wird nicht unterstützt.
  • Mehrere aufeinander folgende Rollbacks werden nicht unterstützt. Sie können ein Rollback von maximal einer Version ausführen.

Registrieren im selbstverwalteten Modus und Auswählen der Version während des Mitgliedsbeitritts

  • Melden Sie sich im SelfManaged Modus an und wählen Sie explizit eine Version während der Mitgliedsverknüpfung aus, indem Sie den az appnet member join Befehl mit dem --upgrade-mode SelfManaged Parameter verwenden und den --version Parameter auf die gewünschte Version setzen.

    az appnet member join \
    --resource-group $APPNET_RG \
    --appnet-name $APPNET_NAME \
    --member-name $APPNET_MEMBER_NAME \
    --member-resource-id /subscriptions/$SUBSCRIPTION/resourcegroups/$AKS_RG/providers/Microsoft.ContainerService/managedClusters/$CLUSTER_NAME \
    --upgrade-mode SelfManaged \
    --version $VERSION

Aktuelle Version überprüfen

  • Überprüfen Sie mit dem az appnet member show-Befehl, welche Version derzeit auf einem Mitglied installiert ist, und schauen Sie sich die Version-Eigenschaft in der Ausgabe an.

    az appnet member show --member-name $APPNET_MEMBER_NAME --appnet-name $APPNET_NAME --resource-group $APPNET_RG

Überprüfen verfügbarer Upgradeversionen

  • Überprüfen Sie, welche Versionen für jede Modus- und Kubernetes-Version in Ihrer Region verfügbar sind, indem Sie den az appnet list-versions Befehl mit dem --location Parameter verwenden, der auf die region von Interesse festgelegt ist. Verweisen Sie in der Ausgabe auf die AvailableUpgrades Spalte, um zu sehen, welche Versionen verfügbar sind.

    az appnet list-versions --location $LOCATION -o table

Initiieren eines Upgrades

  • Initiieren Sie ein Upgrade mithilfe des az appnet member update-Befehls, wobei der --version-Parameter auf die gewünschte Version festgelegt wird, auf die ein Upgrade durchgeführt werden soll.

    az appnet member update --resource-group $APPNET_RG --appnet-name $APPNET_NAME --member-name $APPNET_MEMBER_NAME --version $VERSION

Rollback zu einer früheren Version

  • Führen Sie ein Rollback zu einer zuvor installierten Version mithilfe des az appnet member update Befehls durch, wobei der --version Parameter auf die gewünschte Version festgelegt ist, auf die ein Rollback ausgeführt werden soll. Denken Sie daran, dass nur ein Rollback auf die unmittelbar vorangehende Version (N-1) unterstützt wird.

    az appnet member update --resource-group $APPNET_RG --appnet-name $APPNET_NAME --member-name $APPNET_MEMBER_NAME --version $VERSION

Vollverwalteter Modus

Im FullyManaged Modus verwaltet das Azure Kubernetes-Anwendungsnetzwerk automatisch Versionsupgrades für jedes Mitglied basierend auf dem ausgewählten Veröffentlichungskanal. Wir empfehlen diesen Modus, wenn Sie das Azure Kubernetes-Anwendungsnetzwerk bevorzugen, die Versionsstabilitätsbewertung, das Rollout-Timing und laufende Updates ohne manuelle Eingriffe zu verarbeiten.

Wenn Sie den Upgrademodus verwenden FullyManaged , wählen Sie einen Veröffentlichungskanal aus, der bestimmt, wie schnell Ihre Mitgliedscluster neue Versionen übernehmen. Das Azure Kubernetes-Anwendungsnetzwerk überwacht die Releasebereitschaft und aktualisiert Mitglieder entsprechend den Stabilitätskriterien des Kanals.

Die folgenden Veröffentlichungskanäle sind für FullyManaged Modus bereitgestellt.

  • Rapid: Liefert die neueste Anwendungsnetzwerkversion, sobald sie verfügbar ist. Dieser Kanal ist für Nichtproduktions- oder Frühvalidierungsumgebungen vorgesehen, in denen das Testen neuer Features und Funktionen über längere Gültigkeitsdauer priorisiert wird.
  • Stable: Stellt Versionen zur Verfügung, die zusätzliche Validierung und Tests abgeschlossen haben. Dieser Kanal ist für Produktionsumgebungen vorgesehen und orientiert sich in der Regel an untergeordneter Version N-1, um eine höhere Zuverlässigkeit sicherzustellen und alle Probleme zu beheben, die in früheren Versionen identifiziert wurden.

Wenn der FullyManaged Modus ausgewählt ist, können Sie den Veröffentlichungskanal auf stable oder rapid festlegen. Wenn dieser Parameter nicht angegeben wird, lautet stableder Standardkanal .

Von Bedeutung

Im FullyManaged-Modus wendet das Azure Kubernetes-Applikationsnetzwerk automatisch Upgrades an, sobald neue Versionen über Veröffentlichungskanäle freigegeben werden. Die manuelle Steuerung der Aktualisierungszeitdauer oder der Versionsauswahl wird nicht unterstützt.

Überprüfen der verfügbaren Upgradeversionen auf den vollverwalteten Modus

  • Überprüfen Sie, welcher Version jeder Kanal für eine bestimmte Region und Kubernetes-Version entspricht, indem Sie den Befehl az appnet list-versions verwenden und nach dem Modus FullyManaged mit grep suchen.

    az appnet list-versions --location $LOCATION -o table | grep FullyManaged

Registrieren im vollverwalteten Modus und Auswählen des Veröffentlichungskanals während des Mitgliedsbeitritts

  • Registrieren Sie sich im FullyManaged-Modus, und wählen Sie einen Veröffentlichungskanal während des Beitritts eines Mitglieds mithilfe des az appnet member join-Befehls mit dem --upgrade-mode FullyManaged- Parameter und der Einstellung des --release-channel-Parameters auf den gewünschten Kanal. Das folgende Beispiel zeigt, wie Sie den Kanal während des Rapid Mitgliedsbeitritts auswählen:

    az appnet member join \
    --resource-group $APPNET_RG \
    --appnet-name $APPNET_NAME \
    --member-name $APPNET_MEMBER_NAME \
    --member-resource-id /subscriptions/$SUBSCRIPTION/resourcegroups/$AKS_RG/providers/Microsoft.ContainerService/managedClusters/$CLUSTER_NAME \
    --upgrade-mode FullyManaged \
    --release-channel Rapid \
    --member-location $LOCATION

Aktualisieren der Auswahl des Release-Kanals

Sie können Ihre ausgewählte Version jederzeit aktualisieren. Alle Änderungen am Veröffentlichungskanal werden sofort wirksam.

  • Aktualisieren Sie die Auswahl des Releasekanals für ein vorhandenes Mitglied mithilfe des az appnet member update Befehls, wobei der --release-channel Parameter auf den gewünschten Kanal festgelegt ist. Das folgende Beispiel zeigt, wie Sie zum Stable Kanal für ein vorhandenes Mitglied wechseln:

    az appnet member update --resource-group $APPNET_RG --appnet-name $APPNET_NAME --member-name $APPNET_MEMBER_NAME --release-channel Stable

Verwandte Inhalte

Weitere Informationen zum Azure Kubernetes-Anwendungsnetzwerk finden Sie in den folgenden Artikeln:

  • Zuletzt aktualisiert um