Diese Dokumentation bezieht sich auf die neueste Version von Anthos-Clustern in Azure, die am 3. November veröffentlicht wurde. Weitere Informationen finden Sie in den Versionshinweisen.

Upgrade der Azure-Clusterversion ausführen

Auf dieser Seite wird erläutert, wie Sie die Kubernetes-Version Ihrer Anthos-Cluster auf Azure-Clustern aktualisieren.

Vorbereitung

Das Upgrade der Kubernetes-Version eines Clusters ist ein spezifischer Fall des allgemeineren Aktualisierungsvorgangs des Clusters. Weitere Informationen zu Clusteraktualisierungsvorgängen finden Sie auf der Seite Cluster aktualisieren. So führen Sie ein Upgrade der Clusterversion durch:

  • Sie müssen ein Upgrade über jede Nebenversion zwischen der aktuellen und der Zielversion ausführen. Wenn Sie beispielsweise ein Upgrade von 1.20 auf 1.22 ausführen möchten, müssen Sie zuerst ein Upgrade von 1.20 auf 1.21 und dann ein Upgrade von 1.21 auf 1.22 ausführen.
  • Sie benötigen die Berechtigung gkemulticloud.googleapis.com/azureClusters.update für die Identitäts- und Zugriffsverwaltung.

So führen Anthos-Cluster in Azure Aktualisierungen durch

Da für das Upgrade eines Clusters die Knoten der Steuerungsebene neu gestartet werden müssen, führen Anthos-Cluster in Azure mit den folgenden Schritten ein "Rolling Update" aus:

  1. Wählen Sie eine Instanz der Steuerungsebene aus, die aktualisiert werden soll. Anthos-Cluster on Azure aktualisiert fehlerhafte Instanzen, sofern vorhanden, vor den fehlerfreien.
  2. Löschen Sie die Instanz. Anthos-Cluster auf Azure erstellen die Instanz neu und die Instanz wird mit der neuen Konfiguration gestartet.
  3. Führen Sie Systemdiagnosen für die Instanz durch.
  4. Wenn die Systemdiagnosen erfolgreich sind, wählen Sie eine andere Instanz aus und führen Sie dieselben Schritte für sie aus. Wiederholen Sie diesen Zyklus, bis alle Instanzen neu gestartet oder neu erstellt wurden. Wenn die Systemdiagnose fehlschlägt, versetzt Anthos-Cluster on Azure den Cluster in den Status DEGRADED und beendet das Update. Weitere Informationen finden Sie im folgenden Abschnitt:

Wenn ein Update fehlschlägt

Nach einem Update führt Anthos-Cluster in Azure eine Systemdiagnose für dem Cluster durch. Wenn die Systemdiagnose fehlschlägt, wird der Cluster als DEGRADED markiert. Sie können den Status des Clusters mit dem folgenden Befehl der Google Cloud CLI aufrufen:

gcloud container azure clusters describe CLUSTER_NAME \
  --location=GOOGLE_CLOUD_LOCATION

Dabei gilt:

  • CLUSTER_NAME: der Name Ihres Clusters
  • GOOGLE_CLOUD_LOCATION: die Google Cloud-Region, die Ihren Cluster verwaltet

Führen Sie das Upgrade aus

Clusterversion prüfen

Prüfen Sie vor dem Upgrade Ihrer Clusterversion mit dem folgenden Befehl, welche Versionen in Ihrer Region verfügbar sind:

gcloud container azure get-server-config \
    --location=GOOGLE_CLOUD_LOCATION

Ersetzen Sie GOOGLE_CLOUD_LOCATION durch den Google Cloud-Standort, von dem aus Sie Ihre Cluster verwalten.

Upgrademethode auswählen

Sie können Ihre Clusterversion über die Google Cloud Console, die Google Cloud CLI oder die Anthos Multi-Cloud API aktualisieren. Wenn Sie die Konsole zum Aktualisieren eines Clusters verwenden möchten, müssen Sie zuerst eine Authentifizierungsmethode für die Anmeldung im Cluster auswählen und konfigurieren. Weitere Informationen finden Sie unter Cluster verbinden und authentifizieren.

Console

  1. Rufen Sie in der Google Cloud Console die Anthos-Seite Cluster auf.

    Zur Seite "Anthos-Cluster"

  2. Wählen Sie das Cloud-Projekt aus, in dem sich der Cluster befindet.

  3. Wählen Sie in der Clusterliste den Namen des Clusters aus und klicken Sie dann in der Seitenleiste auf Details anzeigen.

  4. Wählen Sie auf dem Tab Details die Option Upgrade aus.

  5. Wählen Sie im Dialogfeld Kubernetes-Version für den Cluster aktualisieren die Version aus, auf die Sie ein Upgrade ausführen möchten, und klicken Sie auf Fertig. Sie müssen beim Upgrade des Clusters alle Nebenversionen aktualisieren.

gcloud

Führen Sie den folgenden Befehl aus, um die Kubernetes-Version Ihres Clusters zu aktualisieren:

gcloud container azure clusters update CLUSTER_NAME \
    --location=GOOGLE_CLOUD_LOCATION \
    --cluster-version=CLUSTER_VERSION

Dabei gilt:

API

Wenn Sie Ihren Cluster über die API aktualisieren, verwenden Sie einen PATCH-Vorgang über die Anthos Multi-Cloud API.

  1. Erstellen Sie eine JSON-Datei mit dem Namen cluster_update.json und folgendem Inhalt:

    {
        "controlPlane": {
           "version": "CLUSTER_VERSION",
        },
    }
    

    Dabei gilt:

  2. Aktualisieren Sie diese Einstellungen über die Anthos Multi-Cloud API mit dem folgenden Befehl.

    curl -d @cluster_update.json -X PATCH \
       ENDPOINT/projects/PROJECT_ID/locations/GOOGLE_CLOUD_LOCATION/azureClusters/CLUSTER_ID?update_mask=controlPlane.Version
    

Dabei gilt:

Weitere Informationen finden Sie in der Dokumentation zur Methode projects.locations.azureClusters.patch.

Knotenpools aktualisieren

Führen Sie nach dem Upgrade der Clusterversion ein Upgrade Ihrer Knotenpools durch, um den Vorgang abzuschließen. Weitere Informationen finden Sie unter Knotenpool aktualisieren.

Nächste Schritte