Upgrade – Übersicht

Wenn Sie ein Clusterupgrade für die Google Distributed Cloud-Software (nur Software) für VMware planen, können Sie die erforderliche Upgradereihenfolge bestimmen, kompatible Verwaltungstools auswählen und die Unterbrechung von Arbeitslasten in einer Umgebung mit mehreren Clustern minimieren. Eine Checkliste zur Vorbereitung auf das Upgrade finden Sie unter Best Practices für Upgrades.

Auswirkungen von Versionen, Reihenfolge und Tools auf Upgrades

Die Reihenfolge, in der Sie Cluster aktualisieren, die verwendeten Tools und die Prüfungen, die Sie durchführen müssen, variieren je nach Folgendem erheblich:

  • Die Version, mit der Sie beginnen
  • Die Version, auf die Sie ein Upgrade ausführen
  • Ob Sie ein Upgrade von einem erweiterten oder nicht erweiterten Cluster durchführen
  • Ob Sie ein Upgrade auf einen erweiterten oder nicht erweiterten Cluster durchführen
  • Ob die Steuerungsebene V2 im Nutzercluster aktiviert ist

Je nach der Version, von der Sie ausgehen, der Reihenfolge, in der Sie Cluster aktualisieren, den Tools, die Sie für die Aktualisierung verwenden, den Versionen der Cluster und den Möglichkeiten, die Sie haben, gibt es erhebliche Unterschiede.

Prüfen, ob ein Cluster erweitert oder nicht erweitert ist

So finden Sie heraus, ob Ihre Cluster erweitert oder nicht erweitert sind:

  • Wenn Ihre Cluster die Version 1.30 oder früher verwenden, handelt es sich um nicht erweiterte Cluster.
  • Wenn Ihre Cluster Version 1.33 verwenden und Sie die erweiterten Cluster nicht explizit deaktiviert haben, handelt es sich um erweiterte Cluster.
  • Wenn Ihre Cluster die Version 1.34 oder höher verwenden, handelt es sich um erweiterte Cluster.

Wenn Ihre Cluster die Versionen 1.31 und 1.32 verwenden, prüfen Sie mit kubectl, ob ein Cluster erweitert ist oder nicht:

  1. Prüfen Sie in der kubeconfig-Datei des Administratorclusters das Spezifikationsfeld enableAdvancedCluster für den Administratorcluster:

    kubectl get onpremadminclusters -A \
    -o custom-columns=NAME:.metadata.name,VERSION:.spec.gkeOnPremVersion,ADVANCED:.spec.enableAdvancedCluster \
    --kubeconfig ADMIN_CLUSTER_KUBECONFIG

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

  2. Prüfen Sie in der kubeconfig-Datei des Administratorclusters das Spezifikationsfeld enableAdvancedCluster für die Nutzercluster:

    kubectl get onpremuserclusters -A \
    -o custom-columns=NAME:.metadata.name,VERSION:.spec.gkeOnPremVersion,ADVANCED:.spec.enableAdvancedCluster \
    --kubeconfig ADMIN_CLUSTER_KUBECONFIG

Wenn erweiterte Cluster aktiviert sind, sieht die Ausgabe in etwa so aus:

NAME              VERSION           ADVANCED
gke-admin-abc12   1.32.0-gke.1085   true

Wenn ADVANCED den Wert true hat, handelt es sich um einen erweiterten Cluster. In Version 1.32 oder früher wird ADVANCED möglicherweise als <none> angezeigt.

Allgemeiner Upgradeprozess

In den folgenden Abschnitten wird der gesamte Upgradeprozess beim Upgrade von Clustern beschrieben, je nachdem, von welchem Clustertyp Sie ein Upgrade durchführen und auf welchen Clustertyp Sie ein Upgrade durchführen.

Bevor Sie ein Upgrade starten, sollten Sie sich die detaillierten Informationen zu den Auswirkungen von Versionen auf Upgrades ansehen. Eine detaillierte Liste der Abhängigkeiten nach Version sowie Informationen zum Überspringen von Versionen und zu Regeln für Versionsabweichungen finden Sie unter Regeln für Versionsupgrades.

Erweiterte und nicht erweiterte Cluster im Vergleich

Es gibt zwei Arten von Clustern: erweiterte und nicht erweiterte. Alle Cluster, die in Version 1.33 oder höher erstellt wurden, sind erweiterte Cluster. Erweiterte Cluster verwenden verbesserte Architekturen, die mehr Flexibilität und Skalierbarkeit bieten.

Nachdem Sie Ihre Cluster auf erweiterte Cluster aktualisiert haben, verwenden Sie immer erweiterte Cluster und den Upgradevorgang für erweiterte Cluster. Ob ein Cluster erweitert ist oder nicht, ist nur relevant, wenn Sie ein Upgrade von einer Version vor 1.33 durchführen.

Erweiterte Cluster verwenden eine konsolidierte Google Distributed Cloud-Architektur, indem Google Distributed Cloud (nur Software) für Bare Metal als zugrunde liegendes Framework für Google Distributed Cloud (nur Software) für VMware verwendet wird. In Knotenlabels, API-Ressourcen und System-Tags finden Sie möglicherweise Verweise auf „Bare Metal“.

Mit der Funktion für erweiterte Cluster wird eine Clusterarchitektur implementiert, die Google Distributed Cloud (nur Software) für VMware besser auf die anderen Google Distributed Cloud-Produkte abstimmt. Ein Cluster, für den erweiterte Cluster aktiviert sind, hat eine gemeinsame Plattform mit anderen Google Distributed Cloud-Clustern. Diese gemeinsame Plattform verwendet dieselben Controller und Agents, was die Zuverlässigkeit erhöht und Google dabei helfen kann, besseren Support zu bieten. Außerdem wird die Leistung von Clustervorgängen verbessert, wenn erweiterte Cluster aktiviert sind.

Die neue Architektur bietet eine einheitliche Umgebung und Implementierung mit allen anderen Google Distributed Cloud-Angeboten. Weitere Informationen zu den Funktionen, die für erweiterte Cluster im Vergleich zu nicht erweiterten Clustern verfügbar sind, finden Sie unter Unterstützung für erweiterte Clusterfunktionen.

Upgrade von erweiterten Clustern auf erweiterte Cluster (aktuelle Versionen, ab 1.31)

Ab Version 1.32 können Sie beim Upgrade von einem erweiterten Cluster auf einen anderen sowohl Patch-Upgrades als auch sequenzielle Upgrades von Nebenversionen durchführen. In der Vorabversion 1.31 können Sie nur Patch-Versionsupgrades innerhalb der Version 1.31 durchführen.

Für dieses Upgrade können Sie die gkectl-Befehlszeile, die Google Cloud CLI, die Google Cloud -Console oder Terraform verwenden (je nach Version).

Wenn Sie ein Upgrade von einem erweiterten Cluster auf einen erweiterten Cluster durchführen möchten, müssen Sie die folgende Reihenfolge einhalten:

  1. Führen Sie gegebenenfalls ein Upgrade der Administrator-Workstation durch.
  2. Prüfen Sie mit gkectl diagnose cluster, ob Ihr Administratorcluster fehlerfrei ist. Beheben Sie alle Probleme.
  3. Administratorcluster aktualisieren.
  4. Prüfen Sie mit gkectl diagnose cluster, ob das Upgrade erfolgreich war und Ihre Nutzercluster fehlerfrei sind. Beheben Sie alle Probleme.
  5. Aktualisieren Sie die Nutzercluster einzeln. Sie können die Steuerungsebene und die Knotenpools des Nutzerclusters zusammen oder separat aktualisieren. Weitere Informationen finden Sie unter Knotenpools aktualisieren.
  6. Prüfen Sie mit gkectl diagnose cluster, ob das Upgrade erfolgreich war.

Sobald alle Knotenpools in einem Nutzercluster dieselbe Version wie die Steuerungsebene des Nutzerclusters haben, wird der Cluster aktualisiert und das Upgrade ist abgeschlossen.

Die Steuerungsebene für den Nutzercluster wird auf dem Nutzercluster selbst ausgeführt und während des Upgrades des Nutzerclusters aktualisiert. Die Knoten der Steuerungsebene des Administratorclusters werden während des Upgrades des Administratorclusters aktualisiert.

Weitere Informationen zur Diagnose von Clustern mit gkectl diagnose cluster finden Sie unter Cluster diagnostizieren.

Informationen zum Durchführen von Upgrades von erweiterten Clustern auf erweiterte Cluster finden Sie unter Cluster upgraden.

Upgrade von nicht erweiterten Clustern auf erweiterte Cluster

Upgrades von einem nicht erweiterten Cluster auf einen erweiterten Cluster sind nur für die Versionen 1.31, 1.32, 1.33 und 1.34 möglich. Weitere Informationen zum Upgrade von nicht erweiterten Clustern auf erweiterte Cluster in diesen Versionen finden Sie unter Regeln für Versionsupgrades.

Wenn Sie ein Upgrade von einem nicht erweiterten Cluster auf einen erweiterten Cluster durchführen möchten, müssen Sie gkectl mit derselben Version wie die Zielversion verwenden (wenn Sie beispielsweise ein Upgrade auf Version 1.32.0 durchführen, müssen Sie gkectl Version 1.32.0 verwenden) und diese Reihenfolge einhalten:

  1. Führen Sie ein Upgrade der Administrator-Workstation und der Artefakte durch.
  2. Prüfen Sie mit gkectl diagnose cluster, ob Ihr Administratorcluster fehlerfrei ist. Beheben Sie alle Probleme.
  3. Administratorcluster aktualisieren.
  4. Prüfen Sie mit gkectl diagnose cluster, ob das Upgrade erfolgreich war und Ihre Nutzercluster fehlerfrei sind. Beheben Sie alle Probleme.
  5. Führen Sie das Nutzercluster-Upgrade durch.
  6. Prüfen Sie mit gkectl diagnose cluster, ob das Upgrade erfolgreich war.

Weitere Informationen zur Diagnose von Clustern mit gkectl diagnose cluster finden Sie unter Cluster diagnostizieren.

Weitere Informationen zum Upgrade von einem nicht erweiterten Cluster auf einen erweiterten Cluster finden Sie unter Update oder Upgrade von einem nicht erweiterten Cluster auf einen erweiterten Cluster.

Upgrade von einem nicht erweiterten Cluster auf einen nicht erweiterten Cluster

Sie können von nicht erweiterten Clustern auf einen anderen nicht erweiterten Cluster für Version 1.33 und früher upgraden. Details zu Versionen, die Upgrades von einem nicht erweiterten Cluster auf einen anderen nicht erweiterten Cluster zulassen, finden Sie unter Regeln für Upgradeversionen.

Die Reihenfolge, in der Sie nicht erweiterte Cluster aktualisieren, hängt von der Zielversion ab:

  • Für die Zielversionen 1.31, 1.32 und 1.33 müssen Sie den Administratorcluster aktualisieren, bevor Sie die Nutzercluster aktualisieren.
  • Bei Zielversionen bis 1.30 müssen Sie alle Nutzercluster aktualisieren, bevor Sie den Administratorcluster aktualisieren.

Upgrade auf Version 1.31, 1.32 oder 1.33

Wenn Sie ein Upgrade auf Version 1.31, 1.32 oder 1.33 durchführen und Ihre Cluster nicht erweitert bleiben sollen, müssen Sie diese Reihenfolge einhalten:

  1. Führen Sie ein Upgrade der Administratorworkstation durch und bereiten Sie die Bundle-Artefakte vor.
  2. Prüfen Sie mit gkectl diagnose cluster, ob Ihr Administratorcluster fehlerfrei ist. Beheben Sie alle Probleme.
  3. Administratorcluster aktualisieren.
  4. Prüfen Sie mit gkectl diagnose cluster, ob das Upgrade erfolgreich war und Ihre Nutzercluster fehlerfrei sind. Beheben Sie alle Probleme.
  5. Aktualisieren Sie die Nutzercluster einzeln.
  6. Prüfen Sie mit gkectl diagnose cluster, ob das Upgrade erfolgreich war.

Upgrade auf Version 1.30 oder früher

Wenn Sie ein Upgrade auf Version 1.30 oder früher durchführen möchten, müssen Sie diese Reihenfolge einhalten:

  1. Führen Sie ein Upgrade der Administratorworkstation durch und bereiten Sie die Bundle-Artefakte vor.
  2. Prüfen Sie mit gkectl diagnose cluster, ob Ihre Nutzercluster fehlerfrei sind. Beheben Sie alle Probleme.
  3. Aktualisieren Sie alle Nutzercluster einzeln.
  4. Prüfen Sie mit gkectl diagnose cluster, ob das Upgrade erfolgreich war und Ihr Administratorcluster fehlerfrei ist. Beheben Sie alle Probleme.
  5. Administratorcluster aktualisieren.
  6. Prüfen Sie mit gkectl diagnose cluster, ob das Upgrade erfolgreich war.

Weitere Informationen zur Diagnose von Clustern mit gkectl diagnose cluster finden Sie unter Cluster diagnostizieren.

Weitere Informationen zum Upgrade eines nicht erweiterten Clusters auf einen nicht erweiterten Cluster finden Sie unter Nicht erweiterte Cluster aktualisieren und verwalten.

Clusterupgrades

Administratorcluster werden immer einzeln aktualisiert.

Beim Aktualisieren von Nutzerclustern können Sie den gesamten Nutzercluster (die Steuerungsebene und alle Knotenpools im Cluster gleichzeitig) aktualisieren oder die Steuerungsebene des Nutzerclusters aktualisieren und die Knotenpools bei der aktuellen Version belassen. Welchen Ansatz Sie wählen, hängt von mehreren Faktoren ab, unter anderem:

  • Umgebung (Produktion oder Nicht-Produktion), in der sich der Cluster befindet
  • Länge des Wartungsfensters
  • Version des Nutzerclusters

In einer Entwicklungsumgebung ist es wahrscheinlich sinnvoll, den Vorgang einfach zu halten und sowohl die Steuerungsebene des Nutzerclusters als auch alle Knotenpools zu aktualisieren. In einer Produktionsumgebung mit einem kurzen Wartungsfenster sollten Sie jedoch nur die Steuerungsebene aktualisieren, da dies weniger Zeit in Anspruch nimmt. Bei Steuerungsebenen mit Hochverfügbarkeit sollte das Upgrade der Steuerungsebene die Arbeitslasten der Nutzer nicht beeinträchtigen.

Tool zum Upgraden von Clustern auswählen

Welches Tool Sie verwenden, hängt davon ab, wie und was Sie aktualisieren möchten.

Für Administratorcluster müssen Sie gkectl verwenden, um ein Upgrade durchzuführen.

Für Nutzercluster können Sie eines der folgenden Tools verwenden, um Cluster zu aktualisieren:

  • Das gkectl-Befehlszeilentool (erforderlich für Upgrades von nicht erweiterten Clustern auf erweiterte Cluster)
  • Terraform, wenn Sie den Nutzercluster mit Terraform erstellt haben
  • Google Cloud Console
  • Google Cloud CLI

In der folgenden Tabelle sind die Tools und die jeweils unterstützten Anwendungsfälle aufgeführt.

Anwendungsfall für Upgrade gkectl gcloud-CLI Console Terraform Hinweise und Einschränkungen
Administratorcluster upgraden (beliebiger Pfad) Ja Nein Nein Nein Für Administratorcluster ist immer gkectl erforderlich.
Upgrade von nicht erweiterten auf erweiterte Cluster (Konvertierung) Ja Nein Nein Nein Die gkectl-Version muss mit der Zielversion übereinstimmen. Zwischen der Steuerungsebene und den Knotenpools ist keine Versionsabweichung zulässig.
Upgrade von nicht erweiterten auf nicht erweiterte Cluster (Legacy) Ja Nein Nein Nein Nur in Version 1.33 und früher verfügbar (Opt-out-Pfad); API-Clients werden nicht unterstützt.
Nutzercluster upgraden: Advanced zu Advanced Ja Ja Ja Ja1 Es gelten die Standardregeln für Versionsabweichungen.
Gesamten Nutzercluster upgraden (CP und Knotenpools zusammen) Ja Ja Ja Ja1 Wird in allen Tools für erweiterte Nutzercluster unterstützt.
Steuerungsebene des Nutzerclusters separat aktualisieren (nur CP) Ja Ja Nein Ja1 Die Console unterstützt kein eigenständiges Upgrade der Steuerungsebene.
Knotenpools nach CP-Upgrade selektiv upgraden Ja Ja Nein Ja1 Die Console unterstützt keine Upgrades einzelner Knotenpools.
Steuerungsebene und einen oder mehrere Knotenpools gleichzeitig aktualisieren Ja Nein Nein Nein Nur gkectl unterstützt teilweise gleichzeitige Versionsupgrades für Steuerungsebene und Knotenpool.

1 Terraform-Anforderung: Sie können Terraform nur für Upgrades von Nutzerclustern verwenden, wenn der Nutzercluster ursprünglich mit Terraform erstellt und verwaltet wurde.

Wenn Sie Informationen zu Clustern abrufen möchten, die Sie mit gkectl über die Console oder die gcloud CLI erstellt haben, registrieren Sie den Cluster in der GKE On-Prem API.

Nächste Schritte

Lesen Sie die Versionsregeln für Upgrades, um zu verstehen, wie sich Versionen auf Upgrades auswirken, und um die Versionsregeln für die aktuelle Version und die Version, auf die Sie upgraden, zu finden.

Sehen Sie sich die Best Practices für Upgrades an und erstellen Sie einen Plan für das Upgraden Ihrer Cluster.