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:
- Aktualisieren Sie den Administratorcluster von Version
1.Nauf eine Zwischenversion,1.N+1. - Aktualisieren Sie den Administratorcluster von der Zwischenversion
1.N+1auf die Zielversion1.N+2. - Führen Sie nur ein Upgrade der Steuerungsebene des Nutzerclusters von der Quellversion
1.Nauf eine Zwischenversion1.N+1durch. Belassen Sie die Knotenpools auf der Quellversion. Die Zwischenversion ist erforderlich, da die Steuerungsebene jeweils um eine Nebenversion aktualisiert werden muss. - Führen Sie ein Upgrade der Steuerungsebene und der Knotenpools auf die Zielversion
1.N+2durch.
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.
- Wenn Ihr Administratorcluster die Version 1.16 hat, aktualisieren Sie ihn auf 1.28.
- Wenn Ihr Administratorcluster die Version 1.28 hat, aktualisieren Sie ihn auf 1.29.
- 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.
- Aktualisieren Sie den Administratorcluster von Version 1.29 auf die Zwischenversion 1.30.
- Aktualisieren Sie den Administratorcluster auf die Zielversion 1.31.
- 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:
- Aktualisieren Sie nur die Steuerungsebene von der Quellversion
1.Nauf eine Zwischenversion1.N+1. Belassen Sie die Knotenpools auf der Quellversion. Die Zwischenversion ist erforderlich, da die Steuerungsebene jeweils um eine Nebenversion aktualisiert werden muss. - Führen Sie ein Upgrade der Steuerungsebene und der Knotenpools auf die Zielversion
1.N+2durch.
Upgrade mit Überspringen von Versionen durchführen
In diesem Abschnitt finden Sie die Schritte zum Durchführen eines Upgrades mit Überspringen von Versionen.
Hinweis
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).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.
Für ein Upgrade auf Version 1.28 und höher müssen Sie
kubernetesmetadata.googleapis.comaktivieren und dem Dienstkonto für Logging und Monitoring die IAM-Rolle (Identity and Access Management)kubernetesmetadata.publisherzuweisen. 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.
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 FormatX.Y.Z-gke.Nan, z. B.1.34.1100-gke.125:Beschreibung Version Rufen Sie die aktuelle Nutzerclusterversion ab. Dies ist die Quellversion ( 1.N).SOURCE_VERSIONWählen Sie eine Zwischenversion ( 1.N+1) aus.INTERMEDIATE_VERSIONWählen Sie den empfohlenen Patch aus der Ziel-Nebenversion ( 1.N+2) aus.TARGET_VERSIONFühren Sie ein Upgrade der Administrator-Workstation und des Administratorclusters von der Quellversion (
1.N) auf die Zwischenversion (1.N+1) durch:Führen Sie ein Upgrade Ihrer Administrator-Workstation auf die Zwischenversion
INTERMEDIATE_VERSIONdurch und warten Sie, bis das Upgrade abgeschlossen ist.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_KUBECONFIGErsetzen Sie
ADMIN_CLUSTER_KUBECONFIGdurch den Pfad zurkubeconfig-Datei Ihres Administratorclusters.Legen Sie das Feld
bundlePathin der Konfigurationsdatei des Administratorclusters auf das Zwischen-Bundle fest:bundlePath: "/var/lib/gke/bundles/gke-onprem-vsphere-INTERMEDIATE_VERSION.tgz"
Aktualisieren Sie den Administratorcluster auf die Zwischenversion:
gkectl upgrade admin \ --kubeconfig ADMIN_CLUSTER_KUBECONFIG \ --config ADMIN_CLUSTER_CONFIG_FILEErsetzen Sie
ADMIN_CLUSTER_CONFIG_FILEdurch den Pfad Ihrer Konfigurationsdatei für den Administratorcluster.
Führen Sie ein Upgrade der Administrator-Workstation und des Administratorclusters von der Zwischenversion (
1.N+1) auf die Zielversion (1.N+2) durch:Führen Sie ein Upgrade Ihrer Administrator-Workstation auf die Zielversion
TARGET_VERSIONdurch und warten Sie, bis das Upgrade abgeschlossen ist.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_KUBECONFIGLegen Sie das Feld
bundlePathin der Konfigurationsdatei des Administratorclusters auf das Ziel-Bundle fest:bundlePath: "/var/lib/gke/bundles/gke-onprem-vsphere-TARGET_VERSION.tgz"
Aktualisieren Sie den Administratorcluster auf die Zielversion:
gkectl upgrade admin \ --kubeconfig ADMIN_CLUSTER_KUBECONFIG \ --config ADMIN_CLUSTER_CONFIG_FILE
Führen Sie nur ein Upgrade der Steuerungsebene des Nutzerclusters von der Quellversion (
1.N) auf die Zwischenversion (1.N+1) durch:Nehmen Sie die folgenden Änderungen an der Konfigurationsdatei des Nutzerclusters vor:
Setzen Sie das Feld
gkeOnPremVersionauf die ZwischenversionINTERMEDIATE_VERSION.Legen Sie alle Versionen von Worker-Knotenpools in
nodePools[i].gkeOnPremVersionauf die QuellversionSOURCE_VERSIONfest. Wenn Ihr Cluster Load-Balancer-Knotenpools (enableLoadBalancer: true) hat, setzen Sie das FeldgkeOnPremVersionauf 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
Führen Sie ein Upgrade der Steuerungsebene des Nutzerclusters durch:
gkectl upgrade cluster \ --kubeconfig ADMIN_CLUSTER_KUBECONFIG \ --config USER_CLUSTER_CONFIG_FILEErsetzen Sie
USER_CLUSTER_CONFIG_FILEdurch den Pfad zur Konfigurationsdatei Ihres Nutzerclusters.
Aktualisieren Sie die Steuerungsebene des Nutzerclusters und die Worker-Knotenpools auf die Zielversion (
1.N+2):Nehmen Sie die folgenden Änderungen an der Konfigurationsdatei des Nutzerclusters vor:
Legen Sie für das Feld
gkeOnPremVersiondie ZielversionTARGET_VERSIONfest.Legen Sie für jeden Knotenpool
nodePools[i].gkeOnPremVersionauf 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
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.
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.
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.
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.
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.Nhaben, z. B.1.29.700-gke.110.Version Rufen Sie die aktuelle Version 1.29 des Nutzerclusters ab. Dies ist die Quellversion. SOURCE_VERSIONWählen Sie eine Zwischenversion 1.30 aus. INTERMEDIATE_VERSIONWählen Sie die Zielversion 1.31 aus. Wählen Sie den empfohlenen Patch aus der Nebenversion 1.31 aus. TARGET_VERSIONAktualisieren Sie Ihre Administrator-Workstation auf die Zwischenversion 1.30,
INTERMEDIATE_VERSION. Warten Sie, bis eine Meldung angezeigt wird, dass das Upgrade erfolgreich war.Installieren Sie das entsprechende Bundle:
gkectl prepare \ --bundle-path /var/lib/gke/bundles/gke-onprem-vsphere-INTERMEDIATE_VERSION.tgz \ --kubeconfig ADMIN_CLUSTER_KUBECONFIGAktualisieren 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.Installieren Sie das entsprechende Bundle:
gkectl prepare \ --bundle-path /var/lib/gke/bundles/gke-onprem-vsphere-TARGET_VERSION.tgz \ --kubeconfig ADMIN_CLUSTER_KUBECONFIGFühren Sie ein Upgrade nur für die Steuerungsebene des Nutzerclusters auf die Zwischenversion durch:
Nehmen Sie die folgenden Änderungen an der Konfigurationsdatei des Nutzerclusters vor:
Setzen Sie das Feld
gkeOnPremVersionauf die ZwischenversionINTERMEDIATE_VERSION.Legen Sie alle Knotenpoolversionen in
nodePools[i].gkeOnPremVersionauf die QuellversionSOURCE_VERSIONfest.
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 ...
Führen Sie ein Upgrade der Steuerungsebene durch:
gkectl upgrade cluster \ --kubeconfig ADMIN_CLUSTER_KUBECONFIG \ --config USER_CLUSTER_CONFIG_FILEErsetzen Sie
USER_CLUSTER_CONFIGdurch den Pfad Ihrer Konfigurationsdatei für den Nutzercluster.
Legen Sie das Feld
bundlePathin der Konfigurationsdatei des Administratorclusters auf die Zwischenversion 1.30 des Bundles fest:bundlePath: "/var/lib/gke/bundles/gke-onprem-vsphere-INTERMEDIATE_VERSION.tgz"
Aktualisieren Sie den Administratorcluster auf die Zwischenversion 1.30:
gkectl upgrade admin \ --kubeconfig ADMIN_CLUSTER_KUBECONFIG \ --config ADMIN_CLUSTER_CONFIG_FILELegen Sie das Feld
bundlePathin der Konfigurationsdatei des Administratorclusters auf die Zielversion 1.31 des Bundles fest:bundlePath: "/var/lib/gke/bundles/gke-onprem-vsphere-TARGET_VERSION.tgz"
Aktualisieren Sie den Administratorcluster auf die Zielversion 1.31:
gkectl upgrade admin \ --kubeconfig ADMIN_CLUSTER_KUBECONFIG \ --config ADMIN_CLUSTER_CONFIG_FILEFühren Sie ein Upgrade der Steuerungsebene und der Knotenpools auf die Zielversion durch:
Nehmen Sie die folgenden Änderungen an der Konfigurationsdatei des Nutzerclusters vor:
Legen Sie für das Feld
gkeOnPremVersiondie ZielversionTARGET_VERSIONfest.Setzen Sie alle
nodePools[i].gkeOnPremVersionauf 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: "" ...
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.
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 Formatx.y.z-gke.Nhaben, z. B.1.16.11-gke.25.Version Rufen Sie die aktuelle Clusterversion ab. Dies ist die Quellversion ( 1.N).SOURCE_VERSIONWählen Sie eine Zwischenversion ( 1.N+1) aus.INTERMEDIATE_VERSIONWählen Sie die Zielversion ( 1.N+2) aus. Wählen Sie den empfohlenen Patch aus der Ziel-Nebenversion aus.TARGET_VERSIONFühren Sie ein Upgrade Ihrer Administrator-Workstation auf die Zwischenversion
INTERMEDIATE_VERSIONdurch. Warten Sie, bis eine Meldung angezeigt wird, dass das Upgrade erfolgreich war.Installieren Sie das entsprechende Bundle:
gkectl prepare \ --bundle-path /var/lib/gke/bundles/gke-onprem-vsphere-INTERMEDIATE_VERSION.tgz \ --kubeconfig ADMIN_CLUSTER_KUBECONFIGErsetzen Sie
ADMIN_CLUSTER_KUBECONFIGdurch den Pfad derkubeconfig-Datei des Administratorclusters.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.Installieren Sie das entsprechende Bundle:
gkectl prepare \ --bundle-path /var/lib/gke/bundles/gke-onprem-vsphere-TARGET_VERSION.tgz \ --kubeconfig ADMIN_CLUSTER_KUBECONFIGFühren Sie ein Upgrade nur der Steuerungsebene auf die Zwischenversion durch:
Nehmen Sie die folgenden Änderungen an der Konfigurationsdatei des Nutzerclusters vor:
Setzen Sie das Feld
gkeOnPremVersionauf die ZwischenversionINTERMEDIATE_VERSION.Legen Sie alle Knotenpoolversionen in
nodePools[i].gkeOnPremVersionauf die QuellversionSOURCE_VERSIONfest.
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 ...
Führen Sie ein Upgrade der Steuerungsebene durch:
gkectl upgrade cluster \ --kubeconfig ADMIN_CLUSTER_KUBECONFIG \ --config USER_CLUSTER_CONFIG_FILEErsetzen Sie
USER_CLUSTER_CONFIGdurch den Pfad Ihrer Konfigurationsdatei für den Nutzercluster.
Führen Sie ein Upgrade der Steuerungsebene und der Knotenpools auf die Zielversion durch:
Nehmen Sie die folgenden Änderungen an der Konfigurationsdatei des Nutzerclusters vor:
Legen Sie für das Feld
gkeOnPremVersiondie ZielversionTARGET_VERSIONfest.Setzen Sie alle
nodePools[i].gkeOnPremVersionauf 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: "" ...
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