Version beim Upgraden von Knotenpools überspringen

Mit Versionsüberspringungs-Upgrades können Sie eine Nebenversion überspringen, wenn Sie Worker-Knotenpools nach dem Upgrade der Steuerungsebene des Nutzerclusters aktualisieren. Dadurch wird die Anzahl der Knotenentleerungs- und Neustartzyklen reduziert. Wenn ein Worker-Knotenpool beispielsweise Version 1.29 hat, können Sie die Steuerungsebene des Nutzerclusters auf 1.30 und dann auf 1.31 aktualisieren und dann den Worker-Knotenpool direkt von 1.29 auf 1.31 aktualisieren. Diese Funktion wird auf erweiterten und nicht erweiterten Clustern unterstützt, mit Ausnahme von erweiterten Clustern der Version 1.31 und Google Distributed Cloud-Software nur für VMware-Versionen vor 1.28.

Bevor Sie beginnen, sollten Sie sich mit der Upgrade-Übersicht, den Regeln für Upgrade-Versionen, den Best Practices für Upgrades und dem Upgrade eines Clusters vertraut machen.

Beschränkungen

Für Versionsübersprung-Upgrades gelten die folgenden Einschränkungen:

  • Upgrades mit Überspringen von Versionen werden für Ubuntu- und Container-Optimized OS-Knotenpools unterstützt, aber nicht für Windows-Knotenpools.

  • Version 1.31: Diese Funktion ist für erweiterte Cluster nicht verfügbar.

  • Version 1.32 und höher: Diese Funktion ist für erweiterte Cluster verfügbar.

  • Load-Balancer-Knotenpools (Knotenpools mit enableLoadBalancer: true) unterstützen keine Upgrades mit Versionsüberspringung oder Versionsabweichungen. Die Version eines Load-Balancer-Knotenpools muss mit der Clusterversion übereinstimmen.

  • Aufgrund von Kubernetes-Einschränkungen muss die Steuerungsebene eines Nutzerclusters jeweils um eine Nebenversion aktualisiert werden. Beachten Sie jedoch, dass das Upgrade nur der Steuerungsebene deutlich weniger Zeit in Anspruch nimmt und weniger riskant ist als das Upgrade von Knotenpools, in denen Ihre Arbeitslasten ausgeführt werden.

Vorteile von Upgrades mit Versionsübersprung

In diesem Abschnitt werden einige Vorteile von Upgrades mit Versionsüberspringung beschrieben.

Einfachere Verwaltung Ihrer Cluster in einer unterstützten Version

Alle vier Monate wird eine neue Nebenversion von Google Distributed Cloud veröffentlicht. Jede Nebenversion wird ein Jahr lang unterstützt. Damit Ihre Cluster im unterstützten Zeitraum bleiben, müssen Sie etwa alle vier Monate ein Upgrade auf eine Nebenversion durchführen, wie im Folgenden dargestellt:

Dez.

Jan.

Feb.

März

Apr.

Mai

Juni

Juli

Aug.

Sept.

Okt.

Nov.

Dez.

Jan.

Feb.

März

Apr.

Mai

Juni

Juli

Aug.

Sept.

Okt.

Nov.

Dez.

Jan.

Feb.

März

1,14 Upgrade
1,15 Upgrade
1.16 Upgrade
1,28 Upgrade
1,29 Upgrade

Diese Anforderung stellt eine Herausforderung dar, wenn Sie ein langes Validierungsfenster benötigen, um eine neue Nebenversion zu prüfen, und ein kurzes Wartungsfenster, um Ihre Cluster auf die neue Nebenversion zu aktualisieren. Um diese Herausforderungen zu bewältigen, können Sie ein Upgrade mit Versionsübersprung verwenden. Dadurch bleiben Ihre Cluster im unterstützten Zeitfenster, da ein Cluster alle acht Monate statt alle vier Monate aktualisiert wird. In der folgenden Tabelle sehen Sie, dass Sie durch das Überspringen des Upgrades für Version 1.15 erst nach acht Monaten statt nach vier Monaten ein Upgrade durchführen.

Dez.

Jan.

Feb.

März

Apr.

Mai

Juni

Juli

Aug.

Sept.

Okt.

Nov.

Dez.

Jan.

Feb.

März

Apr.

Mai

Juni

Juli

Aug.

Sept.

Okt.

Nov.

Dez.

Jan.

Feb.

März

1,14 Upgrade
1,15
1.16 Upgrade
1,28
1,29

Wenn Sie beim Upgrade Ihrer Knotenpools eine Nebenversion überspringen, verringert sich die Anzahl der Upgrades, die erforderlich sind, um eine unterstützte Version beizubehalten. Außerdem müssen Sie die übersprungene Nebenversion nicht qualifizieren, da sie von der Steuerungsebene nur vorübergehend verwendet wird.

Kürzeres Wartungsfenster

Bei einem Upgrade mit Versionsübersprung müssen Sie Ihr Wartungsfenster nicht vergrößern. Das Überspringen einer Nebenversion beim Upgrade von Knotenpools dauert genauso lange wie das Upgrade der Knotenpools auf die nächste Nebenversion, da jeder Knoten in einem Knotenpool einmal geleert und neu erstellt wird. Daher spart ein Upgrade mit Überspringen von Versionen insgesamt Zeit und reduziert Unterbrechungen der Arbeitslast.

Zusammenfassung

Zusammenfassend bietet ein Upgrade mit Versionsübersprung die folgenden Vorteile:

  • Cluster auf eine unterstützte Version aktualisieren: Google Distributed Cloud unterstützt die drei neuesten Nebenversionen. Wenn Ihre Cluster eine nicht unterstützte Version haben, können Sie je nach Clusterversion eine Nebenversion beim Upgrade von Knotenpools überspringen, um Ihre Cluster mit weniger Upgrades auf eine unterstützte Version zu bringen.

  • Zeit sparen: Das Überspringen einer Nebenversion beim Upgrade von Knotenpools dauert genauso lange wie das Upgrade der Knotenpools auf die nächste Nebenversion. Daher dauert ein Upgrade mit Überspringen einer Version etwa halb so lange wie ein zweimaliges Upgrade von Knotenpools. Bei einem Upgrade mit Versionsübersprung gibt es nur ein Validierungsfenster, im Vergleich zu zwei bei regulären Upgrades.

  • Unterbrechungen reduzieren: Längere Zeiträume zwischen Upgrades und weniger Zeitaufwand für Upgrades und Validierungen bedeuten, dass Ihre Arbeitslasten länger mit weniger Unterbrechungen ausgeführt werden.

Versionen der Steuerungsebene und des Knotenpools während eines Upgrades steuern

In der Konfigurationsdatei des Nutzerclusters ermöglicht das Feld nodePools[i].gkeOnPremVersion, dass ein bestimmter Knotenpool eine andere Version als das Feld gkeOnPremVersion auf oberster Ebene verwendet. Wenn Sie den Wert des Felds nodePools[i].gkeOnPremVersion ändern, können Sie steuern, wann ein Knotenpool aktualisiert wird, wenn Sie gkectl upgrade cluster ausführen. Wenn Sie nodePools[i].gkeOnPremVersion nicht in die Konfigurationsdatei aufnehmen oder das Feld auf einen leeren String setzen, werden Knotenpools auf die gleiche Zielversion aktualisiert, die Sie in gkeOnPremVersion angeben.

Upgrade-Sequenz mit Versionsübersprung

Die Reihenfolge, in der Sie Administrator- und Nutzercluster aktualisieren, hängt von der Clusterversion ab, auf die Sie aktualisieren, der sogenannten Zielversion:

1.32 und höher

Verwenden Sie diese Sequenz, wenn die Zielversion 1.32 oder höher ist. Angenommen, die Steuerungsebene Ihres Nutzerclusters und alle Knotenpools haben die Nebenversion 1.N. Allgemein funktioniert das Upgrade Ihres Clusters von 1.N auf 1.N+2 mit einem Upgrade, bei dem Versionen übersprungen werden, so:

  1. Aktualisieren Sie den Administratorcluster von Version 1.N auf eine Zwischenversion, 1.N+1.
  2. Aktualisieren Sie den Administratorcluster von der Zwischenversion 1.N+1 auf die Zielversion 1.N+2.
  3. Führen Sie nur ein Upgrade der Steuerungsebene des Nutzerclusters von der Quellversion 1.N auf eine Zwischenversion 1.N+1 durch. Belassen Sie die Knotenpools auf der Quellversion. Die Zwischenversion ist erforderlich, da die Steuerungsebene jeweils um eine Nebenversion aktualisiert werden muss.
  4. Führen Sie ein Upgrade der Steuerungsebene und der Knotenpools auf die Zielversion 1.N+2 durch.

1,31

Verwenden Sie diese spezielle Sequenz, wenn der Nutzercluster die Version 1.29 hat. Das bedeutet, dass die Zielversion 1.31 ist. Wenn ein Nutzercluster die Version 1.29 hat, kann ein Administratorcluster, der den Nutzercluster verwaltet, die Version 1.16, 1.28 oder 1.29 haben.

  1. Wenn Ihr Administratorcluster die Version 1.16 hat, aktualisieren Sie ihn auf 1.28.
  2. Wenn Ihr Administratorcluster die Version 1.28 hat, aktualisieren Sie ihn auf 1.29.
  3. Aktualisieren Sie nur die Steuerungsebene des Nutzerclusters von der Quellversion 1.29 auf die Zwischenversion 1.30. Belassen Sie die Knotenpools auf der Quellversion. Die Zwischenversion 1.30 ist erforderlich, da die Steuerungsebene jeweils um eine Nebenversion aktualisiert werden muss.
  4. Aktualisieren Sie den Administratorcluster von Version 1.29 auf die Zwischenversion 1.30.
  5. Aktualisieren Sie den Administratorcluster auf die Zielversion 1.31.
  6. Führen Sie ein Upgrade der Steuerungsebene des Nutzerclusters und der Knotenpools auf die Zielversion 1.31 durch.

1.30 und niedriger

Verwenden Sie diese Sequenz, wenn die Zielversion 1.30 oder niedriger ist.

Angenommen, die Steuerungsebene Ihres Nutzerclusters und alle Knotenpools haben die Nebenversion 1.N. Allgemein funktioniert das Upgrade Ihres Clusters von 1.N auf 1.N+2 mit einem Upgrade, bei dem Versionen übersprungen werden, so:

  1. Aktualisieren Sie nur die Steuerungsebene von der Quellversion 1.N auf eine Zwischenversion 1.N+1. Belassen Sie die Knotenpools auf der Quellversion. Die Zwischenversion ist erforderlich, da die Steuerungsebene jeweils um eine Nebenversion aktualisiert werden muss.
  2. Führen Sie ein Upgrade der Steuerungsebene und der Knotenpools auf die Zielversion 1.N+2 durch.

Upgrade mit Überspringen von Versionen durchführen

In diesem Abschnitt finden Sie die Schritte zum Durchführen eines Upgrades mit Überspringen von Versionen.

Hinweis

  1. Achten Sie darauf, dass die aktuelle Version (die Quellversion) des Clusters Version 1.16 oder höher ist. Prüfen Sie die Version der Steuerungsebene (gkeOnPremVersion) und aller Knotenpools (nodePools[i].gkeOnPremVersion).

  2. In Version 1.29 und später sind serverseitige Preflight-Prüfungen standardmäßig aktiviert. Prüfen Sie Ihre Firewallregeln, um die erforderlichen Änderungen vorzunehmen.

  3. Für ein Upgrade auf Version 1.28 und höher müssen Sie kubernetesmetadata.googleapis.com aktivieren und dem Dienstkonto für Logging und Monitoring die IAM-Rolle (Identity and Access Management) kubernetesmetadata.publisher zuweisen. Weitere Informationen finden Sie unter Google API- und IAM-Anforderungen.

Führen Sie das Upgrade aus

1.32 und höher

Verwenden Sie diese Sequenz, wenn die Zielversion 1.32 oder höher ist.

Prüfen Sie vor dem Start, ob Ihr Administratorcluster mindestens dieselbe Nebenversion (1.N) wie Ihr Nutzercluster hat. Wenn Ihr Nutzercluster die Version 1.30 und Ihr Administratorcluster die Version 1.28 oder 1.29 hat, aktualisieren Sie Ihren Administratorcluster jeweils um eine Nebenversion, bis er die Version 1.30 erreicht. Wenn Sie Ihren Administratorcluster bereits auf 1.N+1 oder 1.N+2 aktualisiert haben, z. B. während des Upgrades eines anderen Nutzerclusters, überspringen Sie die abgeschlossenen Schritte für das Upgrade des Administratorclusters.

  1. Definieren Sie die Quellversion (1.N), die Zwischenversion (1.N+1) und die Zielversion (1.N+2) in den folgenden Platzhaltervariablen. Geben Sie vollständige Versionsnummern im Format X.Y.Z-gke.N an, z. B. 1.34.1100-gke.125:

    Beschreibung Version
    Rufen Sie die aktuelle Nutzerclusterversion ab. Dies ist die Quellversion (1.N). SOURCE_VERSION
    Wählen Sie eine Zwischenversion (1.N+1) aus. INTERMEDIATE_VERSION
    Wählen Sie den empfohlenen Patch aus der Ziel-Nebenversion (1.N+2) aus. TARGET_VERSION
  2. Führen Sie ein Upgrade der Administrator-Workstation und des Administratorclusters von der Quellversion (1.N) auf die Zwischenversion (1.N+1) durch:

    1. Führen Sie ein Upgrade Ihrer Administrator-Workstation auf die Zwischenversion INTERMEDIATE_VERSION durch und warten Sie, bis das Upgrade abgeschlossen ist.

    2. Importieren Sie die Betriebssystem-Images aus dem Zwischen-Bundle in vSphere:

      gkectl prepare \
          --bundle-path /var/lib/gke/bundles/gke-onprem-vsphere-INTERMEDIATE_VERSION.tgz \
          --kubeconfig ADMIN_CLUSTER_KUBECONFIG
      

      Ersetzen Sie ADMIN_CLUSTER_KUBECONFIG durch den Pfad zur kubeconfig-Datei Ihres Administratorclusters.

    3. Legen Sie das Feld bundlePath in der Konfigurationsdatei des Administratorclusters auf das Zwischen-Bundle fest:

      bundlePath: "/var/lib/gke/bundles/gke-onprem-vsphere-INTERMEDIATE_VERSION.tgz"
      
    4. Aktualisieren Sie den Administratorcluster auf die Zwischenversion:

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

      Ersetzen Sie ADMIN_CLUSTER_CONFIG_FILE durch den Pfad Ihrer Konfigurationsdatei für den Administratorcluster.

  3. Führen Sie ein Upgrade der Administrator-Workstation und des Administratorclusters von der Zwischenversion (1.N+1) auf die Zielversion (1.N+2) durch:

    1. Führen Sie ein Upgrade Ihrer Administrator-Workstation auf die Zielversion TARGET_VERSION durch und warten Sie, bis das Upgrade abgeschlossen ist.

    2. Importieren Sie die Betriebssystem-Images aus dem Ziel-Bundle in vSphere:

      gkectl prepare \
          --bundle-path /var/lib/gke/bundles/gke-onprem-vsphere-TARGET_VERSION.tgz \
          --kubeconfig ADMIN_CLUSTER_KUBECONFIG
      
    3. Legen Sie das Feld bundlePath in der Konfigurationsdatei des Administratorclusters auf das Ziel-Bundle fest:

      bundlePath: "/var/lib/gke/bundles/gke-onprem-vsphere-TARGET_VERSION.tgz"
      
    4. Aktualisieren Sie den Administratorcluster auf die Zielversion:

      gkectl upgrade admin \
          --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
          --config ADMIN_CLUSTER_CONFIG_FILE
      
  4. Führen Sie nur ein Upgrade der Steuerungsebene des Nutzerclusters von der Quellversion (1.N) auf die Zwischenversion (1.N+1) durch:

    1. Nehmen Sie die folgenden Änderungen an der Konfigurationsdatei des Nutzerclusters vor:

      • Setzen Sie das Feld gkeOnPremVersion auf die Zwischenversion INTERMEDIATE_VERSION.

      • Legen Sie alle Versionen von Worker-Knotenpools in nodePools[i].gkeOnPremVersion auf die Quellversion SOURCE_VERSION fest. Wenn Ihr Cluster Load-Balancer-Knotenpools (enableLoadBalancer: true) hat, setzen Sie das Feld gkeOnPremVersion auf einen leeren String (""), damit sie mit der Steuerungsebene aktualisiert werden.

      Nachdem Sie die Konfigurationsdatei aktualisiert haben, sieht sie in etwa so aus:

      gkeOnPremVersion: INTERMEDIATE_VERSION
      # Omitted fields
      nodePools:
      - name: pool-1
        gkeOnPremVersion: SOURCE_VERSION
        # Omitted fields
      - name: pool-2
        gkeOnPremVersion: SOURCE_VERSION
        # Omitted fields
      
    2. Führen Sie ein Upgrade der Steuerungsebene des Nutzerclusters durch:

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

      Ersetzen Sie USER_CLUSTER_CONFIG_FILE durch den Pfad zur Konfigurationsdatei Ihres Nutzerclusters.

  5. Aktualisieren Sie die Steuerungsebene des Nutzerclusters und die Worker-Knotenpools auf die Zielversion (1.N+2):

    1. Nehmen Sie die folgenden Änderungen an der Konfigurationsdatei des Nutzerclusters vor:

      • Legen Sie für das Feld gkeOnPremVersion die Zielversion TARGET_VERSION fest.

      • Legen Sie für jeden Knotenpool nodePools[i].gkeOnPremVersion auf einen leeren String ("") fest.

      Nachdem Sie die Konfigurationsdatei aktualisiert haben, sieht sie in etwa so aus:

      gkeOnPremVersion: TARGET_VERSION
      # Omitted fields
      nodePools:
      - name: pool-1
        gkeOnPremVersion: ""
        # Omitted fields
      - name: pool-2
        gkeOnPremVersion: ""
        # Omitted fields
      
    2. Führen Sie ein Upgrade der Steuerungsebene und der Knotenpools des Nutzerclusters durch:

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

1,31

Verwenden Sie diese spezielle Sequenz, wenn der Nutzercluster die Version 1.29 hat. Das bedeutet, dass die Zielversion 1.31 ist. Diese Sequenz ist erforderlich, da sich die Versionsregeln in Version 1.31 geändert haben.

Wenn ein Nutzercluster die Version 1.29 hat, kann ein Administratorcluster, der den Nutzercluster verwaltet, die Version 1.16, 1.28 oder 1.29 haben.

  1. Wenn Ihr Administratorcluster die Version 1.16 hat, führen Sie die Schritte zum Upgrade Ihrer Administratorworkstation und zum Upgrade Ihres Administratorclusters auf Version 1.28 aus.

  2. Wenn Ihr Administratorcluster die Version 1.28 hat, führen Sie die Schritte zum Upgrade Ihrer Administrator-Workstation und zum Upgrade Ihres Administratorclusters auf Version 1.29 aus.

  3. Wenn Sie Speicherplatz auf Ihrer Administrator-Workstation sparen möchten, entfernen Sie die heruntergeladenen Bundles:

    rm /var/lib/gke/bundles/gke-onprem-vsphere-*.tgz
    

Wenn der Administratorcluster und alle Nutzercluster die Version 1.29 haben, können Sie das Upgrade mit Versionsübersprung starten.

  1. Definieren Sie die Quellversion (1.29), eine Zwischenversion (1.30) und die Zielversion (1.31) in den folgenden Platzhaltervariablen. Alle Versionen müssen die vollständige Versionsnummer im Format x.y.z-gke.N haben, z. B. 1.29.700-gke.110.

    Version
    Rufen Sie die aktuelle Version 1.29 des Nutzerclusters ab. Dies ist die Quellversion. SOURCE_VERSION
    Wählen Sie eine Zwischenversion 1.30 aus. INTERMEDIATE_VERSION
    Wählen Sie die Zielversion 1.31 aus. Wählen Sie den empfohlenen Patch aus der Nebenversion 1.31 aus. TARGET_VERSION
  2. Aktualisieren Sie Ihre Administrator-Workstation auf die Zwischenversion 1.30, INTERMEDIATE_VERSION. Warten Sie, bis eine Meldung angezeigt wird, dass das Upgrade erfolgreich war.

  3. Installieren Sie das entsprechende Bundle:

    gkectl prepare \
        --bundle-path /var/lib/gke/bundles/gke-onprem-vsphere-INTERMEDIATE_VERSION.tgz \
        --kubeconfig ADMIN_CLUSTER_KUBECONFIG
    
  4. Aktualisieren Sie Ihre Administrator-Workstation noch einmal, diesmal auf die Zielversion 1.31, TARGET_VERSION. Warten Sie, bis eine Meldung angezeigt wird, dass das Upgrade erfolgreich war.

  5. Installieren Sie das entsprechende Bundle:

    gkectl prepare \
        --bundle-path /var/lib/gke/bundles/gke-onprem-vsphere-TARGET_VERSION.tgz \
        --kubeconfig ADMIN_CLUSTER_KUBECONFIG
    
  6. Führen Sie ein Upgrade nur für die Steuerungsebene des Nutzerclusters auf die Zwischenversion durch:

    1. Nehmen Sie die folgenden Änderungen an der Konfigurationsdatei des Nutzerclusters vor:

      • Setzen Sie das Feld gkeOnPremVersion auf die Zwischenversion INTERMEDIATE_VERSION.

      • Legen Sie alle Knotenpoolversionen in nodePools[i].gkeOnPremVersion auf die Quellversion SOURCE_VERSION fest.

      Nach dem Aktualisieren sollte Ihre Konfigurationsdatei in etwa so aussehen:

      gkeOnPremVersion: INTERMEDIATE_VERSION
      ...
      nodePools:
      - name: pool-1
        gkeOnPremVersion: SOURCE_VERSION
        ...
      - name: pool-2
        gkeOnPremVersion: SOURCE_VERSION
        ...
      
    2. Führen Sie ein Upgrade der Steuerungsebene durch:

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

      Ersetzen Sie USER_CLUSTER_CONFIG durch den Pfad Ihrer Konfigurationsdatei für den Nutzercluster.

  7. Legen Sie das Feld bundlePath in der Konfigurationsdatei des Administratorclusters auf die Zwischenversion 1.30 des Bundles fest:

    bundlePath: "/var/lib/gke/bundles/gke-onprem-vsphere-INTERMEDIATE_VERSION.tgz"
    
  8. Aktualisieren Sie den Administratorcluster auf die Zwischenversion 1.30:

    gkectl upgrade admin \
        --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
        --config ADMIN_CLUSTER_CONFIG_FILE
    
  9. Legen Sie das Feld bundlePath in der Konfigurationsdatei des Administratorclusters auf die Zielversion 1.31 des Bundles fest:

    bundlePath: "/var/lib/gke/bundles/gke-onprem-vsphere-TARGET_VERSION.tgz"
    
  10. Aktualisieren Sie den Administratorcluster auf die Zielversion 1.31:

    gkectl upgrade admin \
        --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
        --config ADMIN_CLUSTER_CONFIG_FILE
    
  11. Führen Sie ein Upgrade der Steuerungsebene und der Knotenpools auf die Zielversion durch:

    1. Nehmen Sie die folgenden Änderungen an der Konfigurationsdatei des Nutzerclusters vor:

      • Legen Sie für das Feld gkeOnPremVersion die Zielversion TARGET_VERSION fest.

      • Setzen Sie alle nodePools[i].gkeOnPremVersion auf einen leeren String.

      Nach dem Aktualisieren sollte Ihre Konfigurationsdatei in etwa so aussehen:

      gkeOnPremVersion: TARGET_VERSION
      ...
      nodePools:
      - name: pool-1
        gkeOnPremVersion: ""
        ...
      - name: pool-2
        gkeOnPremVersion: ""
        ...
      
    2. Führen Sie ein Upgrade der Steuerungsebene und der Knotenpools durch:

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

1.30 und niedriger

Verwenden Sie diese Sequenz, wenn die Zielversion 1.30 oder niedriger ist.

  1. Definieren Sie die Quellversion (1.N), die Zwischenversion (1.N+1) und die Zielversion (1.N+2) in den folgenden Platzhaltervariablen. Alle Versionen müssen die vollständige Versionsnummer im Format x.y.z-gke.N haben, z. B. 1.16.11-gke.25.

    Version
    Rufen Sie die aktuelle Clusterversion ab. Dies ist die Quellversion (1.N). SOURCE_VERSION
    Wählen Sie eine Zwischenversion (1.N+1) aus. INTERMEDIATE_VERSION
    Wählen Sie die Zielversion (1.N+2) aus. Wählen Sie den empfohlenen Patch aus der Ziel-Nebenversion aus. TARGET_VERSION
  2. Führen Sie ein Upgrade Ihrer Administrator-Workstation auf die Zwischenversion INTERMEDIATE_VERSION durch. Warten Sie, bis eine Meldung angezeigt wird, dass das Upgrade erfolgreich war.

  3. Installieren Sie das entsprechende Bundle:

    gkectl prepare \
        --bundle-path /var/lib/gke/bundles/gke-onprem-vsphere-INTERMEDIATE_VERSION.tgz \
        --kubeconfig ADMIN_CLUSTER_KUBECONFIG
    

    Ersetzen Sie ADMIN_CLUSTER_KUBECONFIG durch den Pfad der kubeconfig-Datei des Administratorclusters.

  4. Führen Sie noch einmal ein Upgrade Ihrer Administrator-Workstation durch, diesmal jedoch auf die Zielversion TARGET_VERSION. Warten Sie, bis eine Meldung angezeigt wird, dass das Upgrade erfolgreich war.

  5. Installieren Sie das entsprechende Bundle:

    gkectl prepare \
        --bundle-path /var/lib/gke/bundles/gke-onprem-vsphere-TARGET_VERSION.tgz \
        --kubeconfig ADMIN_CLUSTER_KUBECONFIG
    
  6. Führen Sie ein Upgrade nur der Steuerungsebene auf die Zwischenversion durch:

    1. Nehmen Sie die folgenden Änderungen an der Konfigurationsdatei des Nutzerclusters vor:

      • Setzen Sie das Feld gkeOnPremVersion auf die Zwischenversion INTERMEDIATE_VERSION.

      • Legen Sie alle Knotenpoolversionen in nodePools[i].gkeOnPremVersion auf die Quellversion SOURCE_VERSION fest.

      Nach dem Aktualisieren sollte Ihre Konfigurationsdatei in etwa so aussehen:

      gkeOnPremVersion: INTERMEDIATE_VERSION
      ...
      nodePools:
      - name: pool-1
        gkeOnPremVersion: SOURCE_VERSION
        ...
      - name: pool-2
        gkeOnPremVersion: SOURCE_VERSION
        ...
      
    2. Führen Sie ein Upgrade der Steuerungsebene durch:

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

      Ersetzen Sie USER_CLUSTER_CONFIG durch den Pfad Ihrer Konfigurationsdatei für den Nutzercluster.

  7. Führen Sie ein Upgrade der Steuerungsebene und der Knotenpools auf die Zielversion durch:

    1. Nehmen Sie die folgenden Änderungen an der Konfigurationsdatei des Nutzerclusters vor:

      • Legen Sie für das Feld gkeOnPremVersion die Zielversion TARGET_VERSION fest.

      • Setzen Sie alle nodePools[i].gkeOnPremVersion auf einen leeren String.

      Nach dem Aktualisieren sollte Ihre Konfigurationsdatei in etwa so aussehen:

      gkeOnPremVersion: TARGET_VERSION
      ...
      nodePools:
      - name: pool-1
        gkeOnPremVersion: ""
        ...
      - name: pool-2
        gkeOnPremVersion: ""
        ...
      
    2. Führen Sie ein Upgrade der Steuerungsebene und der Knotenpools durch:

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

Wenn Sie keine weiteren Nutzercluster aktualisieren müssen, entfernen Sie die Bundles von Ihrer Administrator-Workstation, um Speicherplatz zu sparen:

rm /var/lib/gke/bundles/gke-onprem-vsphere-*.tgz

Nächste Schritte