Nicht erweiterten Cluster aktualisieren und als nicht erweitert beibehalten

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

Weitere Informationen finden Sie hier:

Vorbereitung

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

    • Falls erforderlich, lesen Sie den Abschnitt gkectl herunterladen, um eine unterstützte Version von gkectl zu erhalten.
  • Diagnostizieren Sie Ihren Cluster immer, bevor Sie ihn aktualisieren oder upgraden.

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

  • Sie müssen den Administratorcluster aktualisieren, bevor Sie Nutzercluster aktualisieren.

Administratorcluster aktualisieren

  1. Führen Sie bei Bedarf ein Upgrade Ihrer Administrator-Workstation durch.

  2. Betriebssystem-Images in vSphere importieren:

    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: Pfad der kubeconfig-Datei des Administratorclusters.

  3. Legen Sie in der Konfigurationsdatei für den Administratorcluster enableAdvancedCluster auf false fest.

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

  5. Administratorcluster aktualisieren und als einfachen Cluster beibehalten:

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

    Ersetzen Sie Folgendes:

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

    Mit dem Befehl werden alle Knoten im Administratorcluster neu erstellt.

Nutzercluster aktualisieren

  1. Betriebssystem-Images in vSphere importieren:

    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: Pfad der kubeconfig-Datei des Administratorclusters.

  2. Legen Sie enableAdvancedCluster in der Konfigurationsdatei für Nutzercluster auf false fest.

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

  4. Führen Sie das 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: Pfad der kubeconfig-Datei des Administratorclusters.
    • USER_CLUSTER_CONFIG: der Pfad Ihrer Nutzerclusterkonfigurationsdatei.

    Mit dem Befehl werden alle Knoten im Nutzercluster neu erstellt.