Aktualisieren von Kubernetes und Knotenimages über mehrere Cluster hinweg mithilfe von Azure Kubernetes Fleet Manager

Artikel
12/04/2024

Plattformadministratoren, die eine große Anzahl von Clustern verwalten, haben oft Probleme, die Updates mehrerer Cluster (z. B. das Upgrade von Knotenbetriebssystemimages oder Kubernetes-Versionen) auf sichere und vorhersehbare Weise durchzuführen. Um diese Herausforderung zu bewältigen, ermöglicht Ihnen Azure Kubernetes Fleet Manager (Fleet) die Orchestrierung von Updates über mehrere Cluster hinweg mithilfe von Updateausführungen.

Updateausführungen bestehen aus Phasen, Gruppen und Strategien und können manuell für einmalige Updates oder automatisch für fortlaufende regelmäßige Updates unter Verwendung von Auto-Upgrade-Profilen angewendet werden. Bei allen Updateausführungen (manuell oder automatisch) werden die Wartungsfenster für Mitgliedercluster berücksichtigt.

In diesem Handbuch wird beschrieben, wie Updateausführungen konfiguriert und manuell ausgeführt werden.

Voraussetzungen

Lesen Sie die konzeptionelle Übersicht über dieses Feature mit Erläuterungen zu Updatestrategien, -ausführungen, -stages und -gruppen, auf die in dieser Anleitung verwiesen wird.
Sie müssen eine Flottenressource mit einem oder mehreren Mitgliedsclustern haben. Falls nicht, folgen Sie dem Schnellstart, um eine Fleet-Ressource zu erstellen und Azure Kubernetes Service-Cluster (AKS) als Mitglieder aufzunehmen.

Legen Sie die folgenden Umgebungsvariablen fest:

export GROUP=<resource-group>
export FLEET=<fleet-name>
export AKS_CLUSTER_ID=<aks-cluster-resource-id>

Wenn Sie die Azure CLI-Anweisungen in diesem Artikel befolgen, müssen Sie Azure CLI Version 2.58.0 oder höher installiert haben. Informationen zum Ausführen einer Installation oder eines Upgrades finden Sie unter Installieren der Azure-Befehlszeilenschnittstelle.
Sie benötigen außerdem die fleet Azure CLI-Erweiterung, die Sie mit folgendem Befehl installieren können:
```
az extension add --name fleet
```
Führen Sie den Befehl az extension update aus, um auf die neueste Version der veröffentlichten Erweiterung zu aktualisieren:
```
az extension update --name fleet
```

Erstellen von Updateausführungen

Die Updateausführung unterstützt zwei Optionen für die Clusterupgradesequenz:

Nacheinander: Wenn Sie die Reihenfolge der Cluster-Upgrades nicht kontrollieren möchten, bietet one-by-one eine einfache Möglichkeit, alle Mitgliedscluster der Flotte nacheinander zu aktualisieren.
Steuerungssequenz von Clustern mithilfe von Updategruppen und Phasen: Wenn Sie die Clusterupgradesequenz steuern möchten, können Sie Membercluster in Updategruppen und Updatephasen strukturieren. Sie können diese Sequenz als Vorlage in Form einer Updatestrategie speichern. Sie können Updateausführungen später mithilfe der Updatestrategien erstellen, anstatt die Sequenz jedes Mal zu definieren, wenn Sie eine Updateausführung erstellen müssen.

Hinweis

Update führt geplante Wartungsfenster aus, die Sie auf AKS-Clusterebene festlegen. Weitere Informationen finden Sie unter Geplante Wartung über mehrere Mitgliedscluster hinweg. In diesem Artikel wird erläutert, wie Updateausführungen Mitgliedscluster behandeln, die mit geplanten Wartungsfenstern konfiguriert wurden.

Navigieren Sie im Azure-Portal zu Ihrer Azure Kubernetes Fleet Manager-Ressource.
Wählen Sie im Dienstmenü unter Einstellungen Multiclusterupdate>Erstellen einer Ausführung aus.
Geben Sie einen Namen für die Updateausführung ein, und wählen Sie dann Nacheinander für den Upgradetyp aus.
Wählen Sie eine der folgenden Optionen für den Upgradebereich aus:
- Kubernetes-Version für Steuerungsebene und Knotenpools
- Kubernetes-Version nur für die Steuerungsebene des Clusters
- Nur Knotenimageversion
Wählen Sie eine der folgenden Optionen für das Knotenbildaus:
- Letztes Bild: Aktualisiert jeden AKS-Cluster im Updateausführung auf das neueste Bild, das für diesen Cluster in seiner Region verfügbar ist.
- Konsistentes Bild: Da es möglich ist, dass ein Updateausführung AKS-Cluster in mehreren Regionen hat, in denen die neuesten verfügbaren Knoten-Images unterschiedlich sein können (siehe Release Rracker für weitere Informationen). Der Updatelauf wählt das letzte gemeinsame Bild für alle diese Regionen aus, um Konsistenz zu erreichen.
Klicken Sie auf Erstellen, um die Updateausführung zu erstellen.

Erstellen Sie eine Aktualisierungsausführung mithilfe des Befehls az fleet updaterun create mit den ausgewählten Werten für die --upgrade-type und --node-image-selection Flags. Mit dem folgenden Befehl wird eine Aktualisierungsausführung erstellt, die die Kubernetes-Version sowohl für Steuerebenen- als auch für Knotenpools aktualisiert und das neueste Knotenbild verwendet, das für jeden Cluster in seiner Region verfügbar ist.

Das Flag --upgrade-type unterstützt die folgenden Werte:
- Full aktualisiert die Kubernetes-Version für die Steuerungsebene und die Knotenpools zusammen mit den Knotenimages.
- ControlPlaneOnly aktualisiert nur die Kubernetes-Version für die Steuerungsebene des Clusters.
- NodeImageOnly aktualisiert nur die Knotenimages.
Das Flag --node-image-selection unterstützt die folgenden Werte:
- Latest: Aktualisiert jeden AKS-Cluster in der Updateausführung auf das neueste Bild, das für diesen Cluster in seiner Region verfügbar ist.
- Consistent:Da es möglich ist, dass ein Update-Lauf AKS-Cluster in mehreren Regionen hat, in denen die neuesten verfügbaren Knotenbilder unterschiedlich sein können (siehe release tracker für weitere Informationen). Der Updatelauf wählt das letzte gemeinsame Bild für alle diese Regionen aus, um Konsistenz zu erreichen.
```
az fleet updaterun create \
 --resource-group $GROUP \
 --fleet-name $FLEET \
 --name run-1 \
 --upgrade-type Full \
 --kubernetes-version 1.26.0 \
 --node-image-selection Latest
```

Starten Sie die Aktualisierung mit dem Befehl az fleet updaterun start.

az fleet updaterun start \
 --resource-group $GROUP \
 --fleet-name $FLEET \
 --name run-1

Beim Erstellen einer Updateausführung haben Sie die Möglichkeit, den Bereich der Updateausführung zu steuern. Das Flag --upgrade-type unterstützt die folgenden Werte:

ControlPlaneOnly aktualisiert nur die Kubernetes-Version für die Steuerungsebene des Clusters.
Full aktualisiert die Kubernetes-Version für die Steuerungsebene und die Knotenpools zusammen mit den Knotenimages.
NodeImageOnly aktualisiert nur die Knotenimages.

Das Flag --node-image-selection unterstützt auch die folgenden Werte:

Letzte: Aktualisiert jeden AKS-Cluster im Updatelauf auf das neueste Imagev, das für diesen Cluster in seiner Region verfügbar ist.
Konsistent: Da es möglich ist, dass ein Updatelauf AKS-Cluster in mehreren Regionen hat, in denen die neuesten verfügbaren Knoten-Images unterschiedlich sein können (siehe Release Rracker für weitere Informationen). Der Updatelauf wählt das letzte gemeinsame Bild für alle diese Regionen aus, um Konsistenz zu erreichen.

Starten einer Updateausführung:

Führen Sie den folgenden Befehl aus, um Updateausführungen zu starten:

az fleet updaterun start \
 --resource-group $GROUP \
 --fleet-name $FLEET \
 --name <run-name>

Aktualisieren von Clustern mithilfe von Gruppen und Phasen

Sie können eine Updateausführung mithilfe von Updatestages definieren, um die Anwendung von Updates auf verschiedene Updategruppen sequenziell zu ordnen. Beispielsweise kann eine erste Updatephase Mitgliedscluster der Testumgebung aktualisieren, und eine zweite Updatephase würde dann Mitgliedscluster der Produktionsumgebung aktualisieren. Sie können auch eine Wartezeit zwischen den Updatephasen angeben. Sie können diese Sequenz als Vorlage in Form einer Updatestrategie speichern.

Azure portal
Azure-Befehlszeilenschnittstelle

Navigieren Sie im Azure-Portal zu Ihrer Azure Kubernetes Fleet Manager-Ressource.
Wählen Sie im Dienstmenü unter Einstellungen Multiclusterupdate>Erstellen einer Ausführung aus.
Geben Sie einen Namen für die Updateausführung ein, und wählen Sie dann Phasen für den Updatesequenztyp aus.
Wählen Sie Phase erstellen aus, und geben Sie dann einen Namen für die Phase und die Wartezeit zwischen den Phasen ein.
Wählen Sie die Updategruppen, die Sie in diese Phase einbeziehen wollen. Sie können auch die Reihenfolge der Updategruppen angeben, wenn Sie sie in einer bestimmten Reihenfolge aktualisieren möchten. Wählen Sie Erstellen, wenn Sie fertig sind.
Wählen Sie eine der folgenden Optionen für den Upgradebereich aus:
- Kubernetes-Version für Steuerungsebene und Knotenpools
- Kubernetes-Version nur für die Steuerungsebene des Clusters
- Nur Knotenimageversion
Wählen Sie eine der folgenden Optionen für das Knotenbildaus:
- Letztes Bild: Aktualisiert jeden AKS-Cluster im Updateausführung auf das neueste Bild, das für diesen Cluster in seiner Region verfügbar ist.
- Konsistentes Bild: Da es möglich ist, dass ein Updateausführung AKS-Cluster in mehreren Regionen hat, in denen die neuesten verfügbaren Knoten-Images unterschiedlich sein können (siehe Release Rracker für weitere Informationen). Der Updatelauf wählt das letzte gemeinsame Bild für alle diese Regionen aus, um Konsistenz zu erreichen.
Klicken Sie auf Erstellen, um die Updateausführung zu erstellen.

Das Angeben von Phasen und deren Reihenfolge bei jeder Erstellung einer Updateausführung kann sich wiederholen und ist mühsam. Updatestrategien vereinfachen diesen Prozess, indem Sie Vorlagen für Updateausführungen speichern können. Weitere Informationen finden Sie unter Erstellen eines Updatelaufs mithilfe von Updatestrategien.
Wählen Sie im Menü Multiclusterupdate die Updateausführung aus, und wählen Sie dann Start aus.

Erstellen Sie eine JSON-Datei, um die Phasen und Gruppen für die Updateausführung zu definieren. Hier ist ein Beispiel für eine Eingabe aus der Stages-Datei (example-stages.json):

{
    "stages": [
        {
            "name": "stage1",
            "groups": [
                {
                    "name": "group-1a"
                },
                {
                    "name": "group-1b"
                },
                {
                    "name": "group-1c"
                }
            ],
            "afterStageWaitInSeconds": 3600
        },
        {
            "name": "stage2",
            "groups": [
                {
                    "name": "group-2a"
                },
                {
                    "name": "group-2b"
                },
                {
                    "name": "group-2c"
                }
            ]
        }
    ]
}

Erstellen Sie eine Aktualisierungsausführung mithilfe des Befehls az fleet updaterun create , wobei das --stages Flag auf den Namen Der JSON-Datei und die ausgewählten Werte für die --upgrade-type und --node-image-selection Flags festgelegt ist. Mit dem folgenden Befehl wird eine Aktualisierungsausführung erstellt, die die Kubernetes-Version sowohl für Steuerebenen- als auch für Knotenpools aktualisiert und das neueste Knotenbild verwendet, das für jeden Cluster in seiner Region verfügbar ist.

Das Flag --upgrade-type unterstützt die folgenden Werte:
- Full aktualisiert die Kubernetes-Version für die Steuerungsebene und die Knotenpools zusammen mit den Knotenimages.
- ControlPlaneOnly aktualisiert nur die Kubernetes-Version für die Steuerungsebene des Clusters.
- NodeImageOnly aktualisiert nur die Knotenimages.
Das Flag --node-image-selection unterstützt die folgenden Werte:
- Latest: Aktualisiert jeden AKS-Cluster in der Updateausführung auf das neueste Bild, das für diesen Cluster in seiner Region verfügbar ist.
- Consistent:Da es möglich ist, dass ein Update-Lauf AKS-Cluster in mehreren Regionen hat, in denen die neuesten verfügbaren Knotenbilder unterschiedlich sein können (siehe release tracker für weitere Informationen). Der Updatelauf wählt das letzte gemeinsame Bild für alle diese Regionen aus, um Konsistenz zu erreichen.
```
az fleet updaterun create \
 --resource-group $GROUP \
 --fleet-name $FLEET \
 --name run-1 \
 --upgrade-type Full \
 --kubernetes-version 1.26.0 \
 --node-image-selection Latest \
 --stages example-stages.json
```

Starten Sie die Aktualisierung mit dem Befehl az fleet updaterun start.

az fleet updaterun start \
 --resource-group $GROUP \
 --fleet-name $FLEET \
 --name run-1

Erstellen eines Updatelaufs mithilfe von Updatestrategien

Zum Erstellen einer Aktualisierungsausführung müssen Sie die Phasen, Gruppen, die Reihenfolge jedes Mal angeben. Updatestrategien vereinfachen diesen Prozess, indem Sie Vorlagen für Updateausführungen speichern können.

Hinweis

Es ist möglich, mehrere Updateläufe mit eindeutigen Namen aus derselben Updatestrategie zu erstellen.

Sie können eine Updatestrategie mit einer der folgenden Methoden erstellen:

Speichern Sie eine Updatestrategie beim Erstellen eines Updatelaufs

Speichern einer Updatestrategie beim Erstellen einer Updateausführung mithilfe des Azure-Portals:

Verwalten einer Updateausführung

In den folgenden Abschnitten wird erläutert, wie Sie eine Updateausführung mithilfe des Azure-Portals und der Azure CLI verwalten.

Azure portal
Azure-Befehlszeilenschnittstelle

Auf der Seite Multiclusterupdates der Flottenressource können Sie Starten einer Updateausführung, die entweder in Nicht gestartet oder Status Fehlgeschlagen:
Auf der Seite Update mehrerer Cluster der Flottenressource können Sie eine Updateausführung, die sich derzeit im Zustand Wird ausgeführt befindet, über die Schaltfläche Beenden beenden:
Innerhalb einer Updateausführung im Zustand Nicht gestartet, Fehlerhaft oder Wird ausgeführt können Sie eine beliebige Phase auswählen und das Upgrade überspringen:

Analog dazu können Sie auch das Upgrade auf Updategruppen- oder Mitgliedsclusterebene überspringen.

Sie können eine Aktualisierungsausführung starten, die sich entweder im Status Nicht gestartet oder Fehlgeschlagen befindet, indem Sie den az fleet updaterun start Befehl verwenden:
```
az fleet updaterun start \
 --resource-group $GROUP \
 --fleet-name $FLEET \
 --name <run-name>
```
Sie können einen aktuell ausgeführten Update-Vorgang mit dem az fleet updaterun stop Befehl stoppen:
```
az fleet updaterun stop \
 --resource-group $GROUP \
 --fleet-name $FLEET \
 --name <run-name>
```
Sie können Aktualisierungsphasen oder Gruppen überspringen, indem Sie sie im --targets Flag mit dem az fleet updaterun skip Befehl spezifizieren:
```
az fleet updaterun skip \
 --resource-group $GROUP \
 --fleet-name $FLEET \
 --name <run-name> \
 --targets Group:my-group-name Stage:my-stage-name
```
Weitere Informationen finden Sie unter Status der Updateausführung für Ausführungen/Phasen/Gruppen.

Automatisieren von Updateausführungen mithilfe von Profilen für automatische Upgrades

Automatische Aktualisierungsprofile werden verwendet, um Aktualisierungen automatisch in Mitgliedsclustern auszuführen, wenn neue Kubernetes- oder Knotenbildversionen verfügbar gemacht werden.

Weitere Informationen zum Konfigurieren von Profilen für automatische Upgrades finden Sie unter Automatisieren von Upgrades von Kubernetes und Knotenbildern mit Azure Kubernetes Fleet Manager.

Weitere Informationen finden Sie unter Status der Updateausführung für Ausführungen/Phasen/Gruppen.

Nächste Schritte

Anleitung: Aktualisieren Sie automatisch mehrere Cluster mithilfe von Azure Kubernetes Flotten-Manager.

Freigeben über