Upgrade der Azure-Clusterversion ausführen

Auf dieser Seite wird erläutert, wie Sie die Kubernetes-Version Ihrer GKE in 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 werden Aktualisierungen in GKE on Azure durchgeführt

Da für das Upgrade eines Clusters die Knoten der Steuerungsebene neu gestartet werden müssen, führt GKE in Azure mit den folgenden Schritten ein „Rolling Update“ aus:

  1. Wählen Sie eine Instanz der Steuerungsebene aus, die aktualisiert werden soll. GKE on Azure aktualisiert fehlerhafte Instanzen, sofern vorhanden, vor den fehlerfreien.
  2. Löschen Sie die Instanz. GKE on Azure erstellt 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 GKE 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 GKE on 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 CloudStandort, von dem aus Sie Ihre Cluster verwalten.

Upgrademethode auswählen

Sie können Ihre Clusterversion entweder über die Google Cloud -Konsole, die Google Cloud CLI oder die GKE Multi-Cloud API aktualisieren. Wenn Sie einen Cluster über die Console aktualisieren möchten, müssen Sie zuerst eine Authentifizierungsmethode für die Anmeldung im Cluster auswählen und konfigurieren. Weitere Informationen finden Sie unter Verbindung zum Cluster herstellen und sich authentifizieren.

Console

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

    Zu GKE-Clustern

  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 und 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 upgraden 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 GKE 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 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 aktualisieren

Aktualisieren Sie nach dem Upgrade der Clusterversion Ihre Knotenpools, um den Vorgang abzuschließen. Weitere Informationen finden Sie unter Knotenpool aktualisieren.

Nächste Schritte