Upgrade der Knotenpools durchführen

Auf dieser Seite wird beschrieben, wie Sie die Steuerungsebene und Knotenpools in einem Nutzercluster, der mit Google Distributed Cloud (nur Software) auf VMware erstellt wurde, separat aktualisieren. Diese Seite richtet sich an IT-Administratoren und ‑Betreiber, die den Lebenszyklus der zugrunde liegenden technischen Infrastruktur verwalten. Weitere Informationen zu gängigen Rollen und Beispielaufgaben, auf die wir in Google Cloud Inhalten verweisen, finden Sie unter Häufig verwendete GKE-Nutzerrollen und -Aufgaben. Bevor Sie dieses Dokument lesen, sollten Sie mit der Planung und Ausführung von Google Distributed Cloud-Upgrades vertraut sein, wie in den folgenden Artikeln beschrieben:

Beschränkungen

Das separate Upgrade von Knotenpools von der Steuerungsebene hat die folgenden Einschränkungen:

  • Diese Funktion wird für Ubuntu- und COS-Knotenpools unterstützt, aber nicht für Windows-Knotenpools.

  • Diese Funktion ist nicht verfügbar, wenn Sie Nicht-Advanced-Cluster auf Advanced-Cluster aktualisieren. Nicht-Advanced-Cluster werden in Version 1.33 automatisch auf Advanced-Cluster aktualisiert.

  • Version 1.31: Diese Funktion ist in Advanced-Clustern nicht verfügbar.

  • Version 1.32 und höher: Diese Funktion ist in Advanced-Clustern verfügbar.

Warum sollten Sie die Steuerungsebene und Knotenpools separat aktualisieren?

  • Wenn Ihre Cluster Version 1.16 oder höher haben, können Sie beim Upgrade von Knotenpools eine Nebenversion überspringen. Durch ein Upgrade mit Überspringen einer Version wird die Zeit halbiert, die für das sequenzielle Upgrade von Knotenpools um zwei Versionen erforderlich wäre. Außerdem können Sie mit Upgrades mit Überspringen einer Version die Zeit zwischen Upgrades verlängern, die erforderlich sind, um eine unterstützte Version zu verwenden. Wenn Sie die Anzahl der Upgrades reduzieren, werden Unterbrechungen der Arbeitslasten und die Überprüfungszeit verringert. Weitere Informationen finden Sie unter Version beim Upgrade von Knotenpools überspringen.

  • In bestimmten Situationen möchten Sie möglicherweise einige, aber nicht alle Knotenpools in einem Nutzercluster aktualisieren. Beispiel:

    • Sie können zuerst die Steuerungsebene und einen Knotenpool aktualisieren, der nur wenig Traffic hat oder auf dem Ihre am wenigsten kritischen Arbeitslasten ausgeführt werden. Wenn Sie sicher sind, dass Ihre Arbeitslasten in der neuen Version ordnungsgemäß ausgeführt werden, können Sie weitere Knotenpools aktualisieren, bis alle Knotenpools aktualisiert sind.

    • Anstelle eines großen Wartungsfensters für das Cluster-Upgrade können Sie den Cluster in mehreren Wartungsfenstern aktualisieren. Informationen zum Schätzen der Zeit für ein Wartungsfenster finden Sie unter Zeitaufwand schätzen und Wartungsfenster planen.

Hinweis

  1. In Version 1.29 und höher sind serverseitige Preflight-Prüfungen standardmäßig aktiviert. Prüfen Sie Ihre Firewallregeln und nehmen Sie gegebenenfalls Änderungen vor.

  2. Wenn Sie auf Version 1.28 und höher aktualisieren möchten, müssen Sie kubernetesmetadata.googleapis.com aktivieren und dem kubernetesmetadata.publisher IAM-Rolle dem Dienstkonto für Logging und Monitoring gewähren. Weitere Informationen finden Sie unter Google API- und IAM-Anforderungen.

  3. Die aktuelle Version des Clusters muss Version 1.14 oder höher sein.

Steuerungsebene und ausgewählte Knotenpools aktualisieren

Das separate Upgrade der Steuerungsebene eines Nutzerclusters von Worker-Knotenpools wird mit gkectl, der Google Cloud CLI und Terraform unterstützt. Sie können das Upgrade nur mit Terraform ausführen, wenn Sie den Nutzercluster mit Terraform erstellt haben.

gkectl

  1. Definieren Sie die Quellversion und die Zielversion 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 Beschreibung
    SOURCE_VERSION Die aktuelle Clusterversion.
    TARGET_VERSION Wählen Sie die Zielversion aus. Wählen Sie den empfohlenen Patch aus der Ziel-Nebenversion aus.

  2. Aktualisieren Sie Ihre Administrator-Workstation auf die Zielversion. Warten Sie auf eine Meldung, dass das Upgrade erfolgreich war.

  3. Importieren Sie die entsprechenden Betriebssystem-Images in vSphere:

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

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

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

    • Legen Sie das Feld gkeOnPremVersion auf die Zielversion TARGET_VERSION fest.

    • Legen Sie für jeden Knotenpool, den Sie aktualisieren möchten, das Feld nodePools.nodePool[i].gkeOnPremVersion auf den leeren String fest.

      • In Version 1.28 und höher können Sie das Knotenpool-Upgrade beschleunigen, indem Sie das nodePools.nodePool[i].updateStrategy.rollingUpdate.maxSurge Feld auf einen ganzzahligen Wert größer als 1 festlegen. Wenn Sie Knoten mit maxSurge aktualisieren, werden mehrere Knoten in derselben Zeit aktualisiert, die für das Upgrade eines einzelnen Knotens erforderlich ist.

    • Legen Sie für jeden Knotenpool, den Sie nicht aktualisieren möchten, nodePools.nodePool[i].gkeOnPremVersion auf die Quellversion SOURCE_VERSION fest.

    Das folgende Beispiel zeigt einen Teil der Konfigurationsdatei des Nutzerclusters. Es wird angegeben, dass die Steuerungsebene und pool-1 auf TARGET_VERSION aktualisiert werden, pool-2 jedoch auf SOURCE_VERSION bleibt.

    gkeOnPremVersion: TARGET_VERSION
...
nodePools:
- name: pool-1
  gkeOnPremVersion: ""
  ...
- name: pool-2
  gkeOnPremVersion: SOURCE_VERSION
  ...

  5. Aktualisieren Sie die Steuerungsebene und ausgewählte Knotenpools:

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

    Ersetzen Sie USER_CLUSTER_CONFIG durch den Pfad der Konfigurationsdatei des Nutzerclusters.

Zusätzliche Knotenpools aktualisieren

Angenommen, mit pool-1 funktioniert alles gut und Sie möchten jetzt pool-2 aktualisieren.

  1. Legen Sie in der Konfigurationsdatei des Nutzerclusters unter pool-2 für gkeOnPremVersion den leeren String fest:

    gkeOnPremVersion: TARGET_VERSION
...
nodePools:
- name: pool-1
  gkeOnPremVersion: ""
  ...
- name: pool-2
  gkeOnPremVersion: ""
  ...

  2. Führen Sie gkectl update cluster aus, um die Änderung anzuwenden:

    gkectl update cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
  --config USER_CLUSTER_CONFIG

gcloud CLI

Für das Upgrade eines Nutzerclusters sind einige Änderungen am Administratorcluster erforderlich. Mit dem Befehl gcloud container vmware clusters upgrade werden automatisch die folgenden Schritte ausgeführt:

  • Der Administratorcluster wird in der GKE On-Prem API registriert , falls er noch nicht registriert ist.

  • Lädt ein Komponentenpaket auf den Administratorcluster herunter und stellt es dort bereit. Die Version der Komponenten entspricht der Version, die Sie für das Upgrade angeben. Mit diesen Komponenten kann der Administratorcluster Nutzercluster in dieser Version verwalten.

Upgrade der Steuerungsebene durchführen

Führen Sie den folgenden Schritt aus, um die Steuerungsebene des Nutzerclusters zu aktualisieren.

  1. Aktualisieren Sie die Google Cloud CLI-Komponenten:

    gcloud components update

  2. Ändern Sie die Updaterichtlinie für den Cluster:

    gcloud container vmware clusters update USER_CLUSTER_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --upgrade-policy control-plane-only=True

    Ersetzen Sie Folgendes:

    • USER_CLUSTER_NAME: Name des Nutzerclusters, der gelöscht werden soll.

    • PROJECT_ID: Die ID des Flotten-Hostprojekts, zu dem der Nutzercluster gehört. Dies ist das Projekt, das Sie beim Erstellen des Clusters angegeben haben. Wenn Sie den Cluster mit gkectl erstellt haben, ist dies die Projekt-ID im Feld gkeConnect.projectID in der Cluster-Konfigurationsdatei.

    • REGION: Die Google Cloud Region, in der die GKE On-Prem API ausgeführt wird und Metadaten speichert. Wenn Sie den Cluster mit einem GKE On-Prem API-Client erstellt haben, ist dies die Region, die Sie beim Erstellen des Clusters ausgewählt haben. Wenn Sie den Cluster mit gkectl erstellt haben, ist dies die Region, die Sie beim Registrieren des Clusters in der GKE On-Prem API angegeben haben.

  3. Aktualisieren Sie die Steuerungsebene des Clusters:

    gcloud container vmware clusters upgrade USER_CLUSTER_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --version=TARGET_VERSION

    Ersetzen Sie TARGET_VERSION durch die Version, auf die Sie aktualisieren möchten. Wählen Sie den empfohlenen Patch aus der Ziel-Nebenversion aus.

    Die Ausgabe des Befehls sieht in etwa so aus:

    Waiting for operation [projects/example-project-12345/locations/us-west1/operations/operation-1679543737105-5f7893fd5bae9-942b3f97-75e59179] to complete.

    In der Beispielausgabe ist der String operation-1679543737105-5f7893fd5bae9-942b3f97-75e59179 der OPERATION_ID des Vorgangs mit langer Ausführungszeit. Sie können den Status des Vorgangs ermitteln, indem Sie den folgenden Befehl in einem anderen Terminalfenster ausführen:

    gcloud container vmware operations describe OPERATION_ID \
  --project=PROJECT_ID \
  --location=REGION

Upgrade der Knotenpools durchführen

Führen Sie die folgenden Schritte aus, um die Knotenpools zu aktualisieren, nachdem die Steuerungsebene des Nutzerclusters aktualisiert wurde:

  1. Rufen Sie eine Liste der Knotenpools im Nutzercluster ab:

    gcloud container vmware node-pools list
  --cluster=USER_CLUSTER_NAME  \
  --project=PROJECT_ID \
  --location=REGION

  2. Führen Sie für jeden Knotenpool, den Sie aktualisieren möchten, den folgenden Befehl aus:

    gcloud container vmware node-pools update NODE_POOL_NAME \
  --cluster=USER_CLUSTER_NAME  \
  --project=PROJECT_ID \
  --location=REGION \
  --version=TARGET_VERSION

Terraform

  1. Aktualisieren Sie die Google Cloud CLI-Komponenten:

    gcloud components update

  2. Falls noch nicht geschehen, registrieren Sie den Administratorcluster in der GKE On-Prem API. Nachdem der Cluster in der GKE On-Prem API registriert wurde, müssen Sie diesen Schritt nicht noch einmal ausführen.

  3. Laden Sie die neue Version der Komponenten herunter und stellen Sie sie im Administratorcluster bereit:

    gcloud vmware admin-clusters update ADMIN_CLUSTER_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --required-platform-version=TARGET_VERSION

    Ersetzen Sie Folgendes:

    • USER_CLUSTER_NAME: Name des Nutzerclusters, der gelöscht werden soll.

    • PROJECT_ID: Die ID des Flotten-Hostprojekts, zu dem der Nutzercluster gehört. Dies ist das Projekt, das Sie beim Erstellen des Clusters angegeben haben. Wenn Sie den Cluster mit gkectl erstellt haben, ist dies die Projekt-ID im Feld gkeConnect.projectID in der Cluster-Konfigurationsdatei.

    • REGION: Die Google Cloud Region, in der die GKE On-Prem API ausgeführt wird und Metadaten speichert. Wenn Sie den Cluster mit einem GKE On-Prem API-Client erstellt haben, ist dies die Region, die Sie beim Erstellen des Clusters ausgewählt haben. Wenn Sie den Cluster mit gkectl erstellt haben, ist dies die Region, die Sie beim Registrieren des Clusters in der GKE On-Prem API angegeben haben.

    • TARGET_VERSION: Die Version, auf die Sie aktualisieren möchten. Wählen Sie den empfohlenen Patch aus der Ziel-Nebenversion aus.

    Mit diesem Befehl wird die Version der Komponenten, die Sie in --required-platform-version angeben, auf den Administratorcluster heruntergeladen und anschließend bereitgestellt. Mit diesen Komponenten kann der Administratorcluster Nutzercluster in dieser Version verwalten.

  4. Ändern Sie in der Datei main.tf, mit der Sie den Nutzercluster erstellt haben, on_prem_version in der Clusterressource auf die neue Version.

  5. Fügen Sie der Clusterressource Folgendes hinzu, damit nur die Steuerungsebene aktualisiert wird:

    upgrade_policy {
  control_plane_only = true
}

  6. Initialisieren und erstellen Sie den Terraform-Plan:

    terraform init

    Terraform installiert alle erforderlichen Bibliotheken, z. B. den Google Cloud Anbieter.

  7. Prüfen Sie die Konfiguration und nehmen Sie bei Bedarf Änderungen vor:

    terraform plan

  8. Wenden Sie den Terraform-Plan an, um den Nutzercluster zu erstellen:

    terraform apply

Upgrade der Knotenpools durchführen

Führen Sie die folgenden Schritte aus, um Knotenpools zu aktualisieren, nachdem die Steuerungsebene des Nutzerclusters aktualisiert wurde:

  1. Fügen Sie in main.tf in der Ressource für jeden Knotenpool, den Sie aktualisieren möchten, Folgendes hinzu:

    on_prem_version = "TARGET_VERSION"

    Beispiel:

    resource "google_gkeonprem_vmware_node_pool" "nodepool-basic" {
name = "my-nodepool"
location = "us-west1"
vmware_cluster = google_gkeonprem_vmware_cluster.default-basic.name
config {
  replicas = 3
  image_type = "ubuntu_containerd"
  enable_load_balancer = true
}
on_prem_version = "1.16.0-gke.0"
}

  2. Initialisieren und erstellen Sie den Terraform-Plan:

    terraform init

  3. Prüfen Sie die Konfiguration und nehmen Sie bei Bedarf Änderungen vor:

    terraform plan

  4. Wenden Sie den Terraform-Plan an, um den Nutzercluster zu erstellen:

    terraform apply

Fehlerbehebung

Wenn nach dem Upgrade eines Knotenpools ein Problem auftritt, können Sie ein Rollback auf die vorherige Version durchführen. Weitere Informationen finden Sie unter Rollback für einen Knotenpool nach einem Upgrade durchführen.