Upgrade der Azure-Clusterversion ausführen

Auf dieser Seite wird erläutert, wie Sie die Kubernetes-Version Ihrer GKE on Azure-Cluster upgraden.

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ührt GKE on Azure Aktualisierungen durch

Da für das Upgrade eines Clusters ein Neustart der Knoten der Steuerungsebene erforderlich ist, führt GKE on Azure ein Rolling Update mit den folgenden Schritten durch:

  1. Wählen Sie eine Instanz der Steuerungsebene aus, die aktualisiert werden soll. GKE on Azure aktualisiert fehlerhafte Instanzen vor fehlerfreien Instanzen, sofern vorhanden.
  2. Löschen Sie die Instanz. GKE on Azure erstellt die Instanz neu und sie startet mit der neuen Konfiguration.
  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, setzt GKE on Azure den Cluster in den Status DEGRADED und stoppt das Update. Weitere Informationen finden Sie im folgenden Abschnitt:

Wenn ein Update fehlschlägt

Nach einem Update führt GKE on Azure eine Systemdiagnose für den 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

Ersetzen Sie Folgendes:

  • 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 die Clusterversion entweder über die Google Cloud Console, die Google Cloud CLI oder die GKE Multi-Cloud API upgraden. Wenn Sie die Console für das Upgrade eines Clusters verwenden möchten, müssen Sie zuerst eine Authentifizierungsmethode für die Anmeldung beim Cluster auswählen und konfigurieren. Weitere Informationen finden Sie unter Verbindung zum Cluster herstellen und authentifizieren.

Console

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

    Zur Seite "Anthos-Cluster"

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

  3. Wählen Sie in der Clusterliste den Namen des Clusters aus und wählen Sie dann in der Seitenleiste Details ansehen aus.

  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 durchführen möchten, und klicken Sie auf Fertig. Beim Upgrade des Clusters müssen alle Nebenversionen aktualisiert werden.

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

Ersetzen Sie Folgendes:

API

Verwenden Sie zum Aktualisieren des Clusters über die API einen PATCH-Vorgang in der GKE Multi-Cloud API.

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

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

    Ersetzen Sie Folgendes:

  2. Aktualisieren Sie diese Einstellungen über die GKE 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
    

Ersetzen Sie Folgendes:

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

Knotenpools upgraden

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

Nächste Schritte