Cluster aktualisieren oder zu einem erweiterten Cluster upgraden

In diesem Dokument wird beschrieben, wie Sie einen Cluster von Version 1.32 aktualisieren oder auf einen erweiterten Cluster umstellen.

Vorbereitung

Administratorcluster aktualisieren oder auf einen erweiterten Cluster umstellen

Aktualisieren

  1. Vorbereiten auf den erweiterten Cluster:

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

    Ersetzen Sie Folgendes:

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

      /var/lib/gke/bundles/gke-onprem-vsphere-1.32.0-gke.1085-full.tgz
      
    • ADMIN_CLUSTER_KUBECONFIG: Pfad der kubeconfig-Datei des Administratorclusters.

  2. Legen Sie in der Konfigurationsdatei des Administratorclusters enableAdvancedCluster auf true fest.

  3. Aktualisieren Sie den Administratorcluster auf den erweiterten Cluster:

    gkectl update 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.

    Durch den Befehl werden alle Knoten im Admincluster neu erstellt.

Upgrade

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

  2. Vorbereiten auf den erweiterten Cluster:

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

    Ersetzen Sie Folgendes:

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

      /var/lib/gke/bundles/gke-onprem-vsphere-1.32.0-gke.1085-full.tgz
      
    • ADMIN_CLUSTER_KUBECONFIG: Pfad der kubeconfig-Datei des Administratorclusters.

  3. Legen Sie in der Konfigurationsdatei des Administratorclusters enableAdvancedCluster auf true 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 auf den erweiterten Cluster umstellen:

    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.

    Durch den Befehl werden alle Knoten im Verwaltungscluster neu erstellt.

Nachdem der Administratorcluster aktualisiert oder auf einen erweiterten Cluster umgestellt wurde:

  • Ihre vorhandenen nicht erweiterten Nutzercluster funktionieren weiterhin normal.

  • Sie können nur erweiterte Nutzercluster erstellen, die vom erweiterten Administratorcluster verwaltet werden.

Wir empfehlen Ihnen, bald darauf alle Nutzercluster auf erweiterte Cluster umzustellen, um eine einheitliche und voll funktionsfähige Umgebung zu erhalten.

Nutzercluster aktualisieren oder auf erweiterten Cluster umstellen

Aktualisieren

  1. Wenn die Steuerungsebene Ihres Nutzerclusters nicht hochverfügbar ist:

    1. Ändern Sie den Wert von masterNode.replicas von 1 zu 3.

    2. Fügen Sie die statischen IP-Adressen für die Knoten der Steuerungsebene des Nutzerclusters dem Abschnitt network.controlPlaneIPBlock.ips hinzu.

  2. Vorbereiten auf den erweiterten Cluster:

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

    Ersetzen Sie Folgendes:

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

      /var/lib/gke/bundles/gke-onprem-vsphere-1.32.0-gke.1085-full.tgz
      
    • ADMIN_CLUSTER_KUBECONFIG: Pfad der kubeconfig-Datei des Administratorclusters.

  3. Legen Sie enableAdvancedCluster in der Konfigurationsdatei für Nutzercluster auf true fest.

  4. Aktualisieren Sie den Nutzercluster auf den erweiterten Cluster:

    gkectl update 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.

    Durch den Befehl werden alle Knoten im Nutzercluster neu erstellt.

Upgrade

  1. Wenn die Steuerungsebene Ihres Nutzerclusters nicht hochverfügbar ist:

    1. Ändern Sie den Wert von masterNode.replicas von 1 zu 3.

    2. Fügen Sie die statischen IP-Adressen für die Knoten der Steuerungsebene des Nutzerclusters dem Abschnitt network.controlPlaneIPBlock.ips hinzu.

  2. Vorbereiten auf den erweiterten Cluster:

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

    Ersetzen Sie Folgendes:

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

      /var/lib/gke/bundles/gke-onprem-vsphere-1.32.0-gke.1085-full.tgz
      
    • ADMIN_CLUSTER_KUBECONFIG: Pfad der kubeconfig-Datei des Administratorclusters.

  3. Legen Sie in der Konfigurationsdatei für Nutzercluster enableAdvancedCluster auf true fest.

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

  5. Führen Sie ein Upgrade des Nutzerclusters auf den erweiterten Cluster durch:

    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.

    Durch den Befehl werden alle Knoten im Nutzercluster neu erstellt.