Cluster auf einen erweiterten Cluster aktualisieren oder upgraden

In diesem Dokument wird beschrieben, wie Sie ein Update oder Upgrade eines Clusters auf einen erweiterten Cluster ab Version 1.32 durchführen.

Vorbereitung

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

    • Falls erforderlich, lesen Sie den Hilfeartikel gkectl herunterladen, um eine unterstützte Version von gkectl zu erhalten.

  • Diagnostizieren Sie Ihren Cluster immer, bevor Sie ihn auf einen erweiterten Cluster aktualisieren oder upgraden:

    • Führen Sie gkectl diagnose cluster für Ihre Administrator- und Nutzercluster aus, um sicherzustellen, dass sie fehlerfrei sind.
    • Wenn beim Befehl Fehler oder Warnungen gemeldet werden, beheben Sie diese, bevor Sie das Update oder Upgrade auf einen erweiterten Cluster starten.

  • Achten Sie darauf, dass in Ihren Clustern nur empfohlene Funktionen verwendet werden.

  • Prüfen Sie vor dem Update oder Upgrade, ob Ihre Cluster Funktionen verwenden, die von erweiterten Clustern nicht unterstützt werden. Wenn nicht unterstützte Funktionen aktiv sind, müssen Sie sie zuerst mit update deaktivieren.

    • Obwohl HA-Nutzercluster (hochverfügbare Nutzercluster) für erweiterte Cluster erforderlich sind, können Sie einen Nicht-HA-Nutzercluster weiterhin gemäß dieser Anleitung zu einem erweiterten HA-Cluster aktualisieren oder upgraden.

  • Sie müssen den Administratorcluster auf einen erweiterten Cluster aktualisieren oder upgraden, bevor Sie Nutzercluster aktualisieren oder upgraden.

  • Informationen zur Installation von cert-manager: cert-manager wird automatisch auf erweiterten Clustern installiert. Wenn Sie von einem nicht erweiterten Cluster zu einem erweiterten Cluster migrieren, überschreibt die integrierte cert-manager automatisch alle vom Kunden installierten Versionen von cert-manager. Achten Sie darauf, dass auf Ihre vorhandenen cert-manager keine kritischen benutzerdefinierten Konfigurationen oder Funktionen angewendet werden, bevor Sie ein Update oder Upgrade auf erweiterte Cluster durchführen. Weitere Informationen finden Sie unter Auf cert-manager upgraden, das in Advanced Clusters enthalten ist.

Administratorcluster auf einen erweiterten Cluster aktualisieren oder upgraden

Aktualisieren

  1. Diagnostizieren Sie Ihren Cluster, um sicherzustellen, dass er fehlerfrei ist:

    gkectl diagnose cluster \
    --kubeconfig ADMIN_CLUSTER_KUBECONFIG
    • Wenn der Befehl Fehler oder Warnungen meldet, lesen Sie den Abschnitt Clusterprobleme diagnostizieren und beheben Sie die Probleme, bevor Sie fortfahren.

  2. Vorbereitung für den erweiterten Cluster:

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

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

    Mit dem Befehl werden alle Knoten im Admincluster neu erstellt.

Upgrade

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

  2. Diagnostizieren Sie Ihren Cluster, um sicherzustellen, dass er fehlerfrei ist:

    gkectl diagnose cluster \
    --kubeconfig ADMIN_CLUSTER_KUBECONFIG
    • Wenn der Befehl Fehler oder Warnungen meldet, lesen Sie den Abschnitt Clusterprobleme diagnostizieren und beheben Sie die Probleme, bevor Sie fortfahren.

  3. Vorbereitung für den erweiterten Cluster:

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

    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.32.0-gke.1085-full.tgz

    • ADMIN_CLUSTER_KUBECONFIG: Pfad der kubeconfig-Datei des Administratorclusters.

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

  5. 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.

  6. Administratorcluster auf den erweiterten Cluster aktualisieren:

    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. Bei der Roll-out-Strategie „Neu erstellen“ werden die Knoten einzeln aktualisiert. Während des Knoten-Upgrades wird die VM gelöscht und dann mit der neuen Version neu erstellt.

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

  • Ihre vorhandenen Nutzercluster, die nicht auf dem erweiterten Modus basieren, funktionieren weiterhin normal.

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

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

Nutzercluster auf Advanced Cluster aktualisieren oder upgraden

Aktualisieren

  1. Diagnostizieren Sie Ihren Cluster, um sicherzustellen, dass er fehlerfrei ist:

    gkectl diagnose cluster \
    --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
    --cluster-name USER_CLUSTER_NAME
    • Wenn der Befehl Fehler oder Warnungen meldet, lesen Sie den Abschnitt Clusterprobleme diagnostizieren und beheben Sie die Probleme, bevor Sie fortfahren.

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

    1. Ändere 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.

  3. Vorbereitung für den erweiterten Cluster:

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

    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.32.0-gke.1085-full.tgz

    • ADMIN_CLUSTER_KUBECONFIG: Pfad der kubeconfig-Datei des Administratorclusters.

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

  5. 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.

    Mit dem Befehl werden alle Knoten im Nutzercluster neu erstellt. Bei der Roll-out-Strategie „Deployment neu erstellen“ werden die Knoten einzeln aktualisiert. Während des Knotenupdates wird die VM gelöscht und dann mit der neuen Konfiguration neu erstellt.

Upgrade

  1. Diagnostizieren Sie Ihren Cluster, um sicherzustellen, dass er fehlerfrei ist:

    gkectl diagnose cluster \
    --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
    --cluster-name USER_CLUSTER_NAME
    • Wenn der Befehl Fehler oder Warnungen meldet, lesen Sie den Abschnitt Clusterprobleme diagnostizieren und beheben Sie die Probleme, bevor Sie fortfahren.

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

    1. Ändern Sie masterNode.replicas von 1 in 3.

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

  3. Vorbereitung für den erweiterten Cluster:

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

    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.32.0-gke.1085-full.tgz

    • ADMIN_CLUSTER_KUBECONFIG: Pfad der kubeconfig-Datei des Administratorclusters.

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

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

  6. Führen Sie das Nutzercluster-Upgrade 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.

    Mit dem Befehl werden alle Knoten im Nutzercluster neu erstellt.

cert-manager mit erweiterten Clustern gebündelt

cert-manager ist eine obligatorische, vom System verwaltete Komponente in erweiterten Clustern.

Wenn Sie cert-manager ohne erweiterte Cluster verwenden, prüfen Sie Folgendes, bevor Sie ein Upgrade auf erweiterte Cluster durchführen:

  • In Ihrer cert-manager gibt es keine benutzerdefinierten Konfigurationen oder Funktionskennzeichen.
  • Ihre cert-manager-Version ist dieselbe Version oder eine Version hinter der mitgelieferten Version.

Apigee Hybrid-Kompatibilität

Das gebündelte cert-manager ist vollständig mit Apigee Hybrid-Arbeitslasten kompatibel. Wenn Sie ein Upgrade auf einen erweiterten Cluster durchführen, werden Sie vom Installationsprogramm möglicherweise gewarnt, dass die vorhandene cert-manager-Installation ersetzt wird. Dieses Verhalten ist normal und wird vom System automatisch gehandhabt.

So sorgen Sie für einen reibungslosen Übergang Ihrer Apigee-Arbeitslasten:

  • Deinstallieren Sie die vorhandene cert-manager nicht manuell vor dem Upgrade.
  • Anpassungen zurücksetzen: Wenn Sie cert-manager mit GitOps verwalten oder benutzerdefinierte Konfigurationen auf die cert-manager-Bereitstellung angewendet haben, müssen Sie diese Anpassungen zurücksetzen oder die Synchronisierung vor dem Upgrade anhalten, um Konfigurationsabweichungen und potenzielle Upgrade-Pausen zu vermeiden.

Funktionen und Beschränkungen

Mit dem gebündelten cert-manager haben Sie folgende Möglichkeiten:

  • Issuer- und ClusterIssuer-Ressourcen erstellen und bearbeiten
  • Zertifikatsressourcen erstellen und bearbeiten, die auf Aussteller und Standardausstellertypen verweisen
  • Standard-Kubernetes-Ressourcen erstellen und bearbeiten, die von cert-manager verwendet werden.
  • Erstellen Sie Kubernetes-Secrets mit API-Schlüsseln und verweisen Sie in Ihren Ausstellern darauf.
  • Aussteller für die Verwendung bestimmter HTTP-01- oder DNS-01-Solver konfigurieren

Folgendes kann in der gebündelten cert-manager nicht angepasst werden:

  • Legen Sie die Werte für deployment oder helm fest.
  • Fügen Sie dem cert-manager-Binärprogramm Befehlszeilenargumente oder Flags hinzu.
  • Ändern Sie Ressourcenlimits oder Knotenauswahlen für cert-manager-Pods.
  • Ändern Sie die Installationslogik der cert-manager-Software.
  • Aktivieren Sie experimentelle Funktionen.
  • Erzwingen, dass cert-manager-Steuerungsebenen-Pods auf bestimmten Infrastrukturnodes ausgeführt werden.

Wenn Sie bestimmte Einschränkungen haben, die die Verwendung der gebündelten cert-manager verhindern, wenden Sie sich an denGoogle Cloud -Support, um Unterstützung bei erweiterten Konfigurationsoptionen zu erhalten.

Gebündelte Versionen

In der folgenden Tabelle sind die gebündelten cert-manager-Versionen für jede Version von Google Distributed Cloud (nur Software) für VMware aufgeführt.

Google Distributed Cloud (nur Software) für VMware Gebündelte cert-manager-Version
1,32 1.17
1.33 1.18
1,34 1.19

Wichtige Unterschiede nach der Umstellung auf erweiterte Cluster

Wenn Sie Ihren Cluster auf einen erweiterten Cluster upgraden oder aktualisieren, ergeben sich im Vergleich zu Standardclustern einige wichtige Unterschiede. Die wichtigsten Änderungen bei erweiterten Clustern:

  • Ressourcenstandort: Cluster- und Maschinenressourcen befinden sich nicht mehr in Nutzerclustern. Diese Ressourcen befinden sich ausschließlich im Administratorcluster.

  • NodeExternalIP: Die NodeExternalIP ist für die Knoten nicht festgelegt.

  • cert-manager-Installation: cert-manager wird automatisch auf erweiterten Clustern installiert. Wenn Sie cert-manager in Ihrem Cluster installiert haben, wird es durch das Aktualisieren oder Upgraden auf einen erweiterten Cluster mit der erweiterten Clusterversion überschrieben.

Eine umfassende Übersicht über die Unterschiede bei den Funktionen finden Sie in der Vergleichstabelle der Funktionen.