Upgrade eines nicht erweiterten Clusters der Version 1.32 durchführen und ihn als nicht erweitert beibehalten

Standardmäßig wird ein nicht erweiterter Cluster automatisch zu einem erweiterten Cluster aktualisiert, wenn Sie ein Upgrade auf Version 1.33 durchführen. Wir empfehlen zwar, ein Upgrade eines nicht erweiterten Clusters auf einen erweiterten Cluster durchzuführen. Wenn Sie jedoch ein Upgrade von Version 1.32 auf 1.33 durchführen und den Cluster als nicht erweitert beibehalten möchten, folgen Sie der Anleitung in diesem Dokument.

Das Beibehalten eines Clusters als nicht erweitert wird nur für das Upgrade von Version 1.32 auf 1.33 unterstützt. Wenn Sie ein Upgrade eines nicht erweiterten Clusters von Version 1.33 auf 1.34 durchführen, wird der Cluster immer in einen erweiterten Cluster konvertiert.

Weitere Informationen finden Sie hier:

• Informationen zum Upgrade auf Version 1.32 und früher finden Sie unter Cluster upgraden.

• Informationen zum Upgrade eines nicht erweiterten Clusters auf einen erweiterten Cluster, siehe Cluster auf einen erweiterten Cluster aktualisieren oder upgraden.

Vorbereitung

• Die gkectl-Version muss mit der Zielclusterversion übereinstimmen.

  • Falls erforderlich, finden Sie unter Herunterladen gkectl eine unterstützte Version von gkectl.

• Führen Sie immer eine Diagnose Ihres Clusters durch, bevor Sie ihn aktualisieren oder upgraden.

• Achten Sie darauf, dass Ihre Cluster nur empfohlene Funktionen verwenden.

• Sie müssen ein Upgrade des Administratorclusters durchführen, bevor Sie ein Upgrade eines Nutzerclusters durchführen.

Administratorcluster aktualisieren

1. Aktualisieren Sie bei Bedarf Ihre Administrator-Workstation.

2. Importieren Sie Betriebssystem-Images in vSphere:

   gkectl prepare \
       --bundle-path BUNDLE_PATH \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
       --advanced-cluster=false
   

   Ersetzen Sie Folgendes:

   • BUNDLE_PATH: der Pfad der Bundle-Datei. Diese Datei befindet sich auf Ihrer Administrator-Workstation in /var/lib/gke/bundles/. Beispiel:

     /var/lib/gke/bundles/gke-onprem-vsphere-1.33.0-gke.799-full.tgz
     

   • ADMIN_CLUSTER_KUBECONFIG: der Pfad der kubeconfig-Datei des Administratorclusters.

3. Legen Sie enableAdvancedCluster in der Konfigurationsdatei des Administratorclusters auf false fest.

4. Achten Sie darauf, dass das Feld bundlepath in der Konfigurationsdatei des Administratorclusters mit dem Pfad des Bundles übereinstimmt, auf das Sie ein Upgrade durchführen möchten.

5. Führen Sie ein Upgrade des Administratorclusters durch und behalten Sie ihn als nicht erweiterten Cluster bei:

   gkectl upgrade admin \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
       --config ADMIN_CLUSTER_CONFIG
   

   Ersetzen Sie Folgendes:

   • ADMIN_CLUSTER_KUBECONFIG: der Pfad der kubeconfig-Datei des Administratorclusters.
   • ADMIN_CLUSTER_CONFIG: der Pfad der Konfigurationsdatei des Administratorclusters.

   Mit dem Befehl werden alle Knoten im Administratorcluster neu erstellt. Bei der Bereitstellungsstrategie „Rollout neu erstellen“ werden die Knoten einzeln aktualisiert. Während des Knotenupgrades wird die VM gelöscht und dann mit der neuen Version neu erstellt.

Nutzercluster aktualisieren

**Wichtig**: Achten Sie darauf, dass der Administratorcluster bereits aktualisiert wurde.

1. Importieren Sie Betriebssystem-Images in vSphere:

   gkectl prepare \
       --bundle-path BUNDLE_PATH \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
       --advanced-cluster=false
   

   Ersetzen Sie Folgendes:

   • BUNDLE_PATH: der Pfad der Bundle-Datei. Diese Datei befindet sich auf Ihrer Administrator-Workstation in /var/lib/gke/bundles/. Beispiel:

     /var/lib/gke/bundles/gke-onprem-vsphere-1.33.0-gke.799-full.tgz
     

   • ADMIN_CLUSTER_KUBECONFIG: der Pfad der kubeconfig-Datei des Administratorclusters.

2. Legen Sie enableAdvancedCluster in der Konfigurationsdatei des Nutzerclusters auf false fest.

3. Achten Sie darauf, dass das Feld gkeOnPremVersion in der Konfigurationsdatei des Nutzerclusters mit der Zielversion Ihres Upgrades übereinstimmt.

4. Führen Sie ein Upgrade des Nutzerclusters durch und behalten Sie ihn als nicht erweiterten Cluster bei:

   gkectl upgrade cluster \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
       --config USER_CLUSTER_CONFIG
   

   Ersetzen Sie Folgendes:

   • ADMIN_CLUSTER_KUBECONFIG: der Pfad der kubeconfig-Datei des Administratorclusters.
   • USER_CLUSTER_CONFIG: der Pfad der Konfigurationsdatei des Nutzerclusters.

   Mit dem Befehl werden alle Knoten im Nutzercluster neu erstellt.