Upgrade der Azure-Clusterversion ausführen

Auf dieser Seite wird erläutert, wie Sie die Kubernetes-Version Ihrer GKE on Azure-Cluster 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 für Identity and Access Management gkemulticloud.googleapis.com/azureClusters.update.

So führen GKE on Azure-Cluster Aktualisierungen durch

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

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

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 entweder über die Google Cloud Console, die Google Cloud CLI oder die GKE Multi-Cloud API aktualisieren. Wenn Sie die Console verwenden möchten, um ein Upgrade eines Clusters durchzuführen, müssen Sie zuerst eine Authentifizierungsmethode für die Anmeldung beim Cluster auswählen und konfigurieren. Weitere Informationen finden Sie unter Mit Ihrem Cluster verbinden und authentifizieren.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Google Kubernetes Engine-Cluster Übersicht 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 ein Upgrade durchführen möchten, und klicken Sie auf Fertig. Beachten Sie, dass Sie beim Upgrade des Clusters alle Nebenversionen aktualisieren müssen.

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:

    • CLUSTER_VERSION: die neue unterstützte Clusterversion. Beachten Sie, dass Sie beim Upgrade Ihres Clusters alle Nebenversionen aktualisieren müssen.

  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

Dabei gilt:

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

Upgrade der Knotenpools durchführen

Nachdem Sie die Clusterversion aktualisiert haben, aktualisieren Sie die Knotenpools, um den Vorgang abzuschließen. Weitere Informationen finden Sie unter Knotenpool aktualisieren.

Nächste Schritte