Cluster aktualisieren

In diesem Dokument wird gezeigt, wie Sie ein Clusterupdate durchführen, das keine Versionsänderung enthält.

Ein Clusterupdate ist eine Änderung der Clusterkonfiguration.

Ein Clusterupgrade ist ein Sonderfall einer Clusteraktualisierung, der eine Änderung an der Version der Steuerungsebene oder eine Änderung an einer Knotenpoolversion umfasst. Informationen zum Upgrade finden Sie unter Google Distributed Cloud aktualisieren.

Firewallregeln prüfen

In Version 1.29 und höher sind serverseitige Preflight-Prüfungen standardmäßig aktiviert. Für serverseitige Preflight-Prüfungen sind zusätzliche Firewallregeln erforderlich. Suchen Sie in den Firewallregeln für Administratorcluster nach „Preflight-Prüfungen“ und achten Sie darauf, dass alle erforderlichen Firewallregeln konfiguriert sind.

Wenn Sie bei serverseitigen Preflight-Prüfungen einen Nutzercluster mit gkectl aktualisieren, werden die Preflight-Prüfungen im Administratorcluster statt lokal auf der Administrator-Workstation ausgeführt. Serverseitige Preflight-Prüfungen werden im Administratorcluster ausgeführt, wenn Sie einen Cluster mit der Google Cloud Console, der Google Cloud CLI oder Terraform aktualisieren.

Wenn Sie einen Administratorcluster aktualisieren, stellt Google Distributed Cloud einen Kubernetes in Docker-Cluster (Art) bereit, um vorübergehend die Kubernetes-Controller zu hosten, die zum Aktualisieren des Administratorclusters erforderlich sind. Dieser vorübergehende Cluster wird als Bootstrap-Cluster bezeichnet. Serverseitige Preflight-Prüfungen werden auf dem Bootstrap-Cluster ausgeführt, wenn Sie einen Administratorcluster aktualisieren.

Was kann aktualisiert werden?

Einige Clusterfeatures und -einstellungen können aktualisiert werden. Andere Features und Einstellungen können jedoch nach dem Erstellen des Clusters nicht mehr aktualisiert werden. Welche Funktionen aktualisiert werden können, erfahren Sie auf den Referenzseiten für die Konfigurationsdatei des Administratorclusters und die Konfigurationsdatei des Nutzerclusters. Nicht aktualisierbare Felder werden als Veränderlich markiert und nicht aktualisierte Felder werden als Unveränderlich markiert.

Mit gkectl-Befehlen können Sie auch sehen, welche Features und Einstellungen aktualisiert werden können.

So sehen Sie, was in einem Administratorcluster aktualisiert werden kann:

gkectl update admin --help

Beispielausgabe:

Update the admin cluster. Only the following updates are supported and they can
only be updated one at a time:
- Enabling/Disabling Vsphere Resource Metrics
- Adding static IPs
- Updating vCenter CA certificate
- Registering Admin Cluster
- Enabling/Disabling Cloud Audit Logging
- Enabling/Disabling Stackdriver
- Enabling/Disabling Auto Repair
- Enabling/Disabling Auto Resize for Addon Nodes
- Enabling/Disabling GKE OnPrem API
- Updating OS Image Type
- Enabling/Disabling AntiAffinityGroups
- Update Secrets Encryption Configuration
- [Preview] Enabling/Disabling Cluster Backup
- [Preview] Update Cluster Backup configs

So sehen Sie, was in einem Nutzercluster aktualisiert werden kann:

gkectl update cluster --help

Beispielausgabe:

Update a GKE On-Prem cluster. Only the following updates are supported and they
can only be updated one at a time:
- Adding static IPs
- Updating node pool
- Updating user master cpu and memory
- Enabling/Disabling Vsphere Resource Metrics
- Enabling/Disabling vSphere CSI deployment
- Enabling/Disabling Auto Repair
- Enabling/Disabling Cloud Audit Logging
- Enabling/Disabling Stackdriver
- Enabling/Disabling GKE OnPrem API
- Registering User Cluster
- Updating vCenter CA certificate
- Updating MetalLB Address Pools
- Enabling/Disabling Auto Resizing on user master
- Updating NodePoolUpdatePolicy
- Enabling/Disabling AntiAffinityGroups
- [Preview] Enabling/Disabling Node Network Policy
- Updating Secrets Encryption
- Enabling/Disabling DataplaneV2 forwardMode

Daten einzeln aktualisieren

Aktualisieren Sie jeweils nur eine Funktion oder Einstellung. Angenommen, Sie möchten Master-CPU und -Arbeitsspeicher aktualisieren und auch die automatische Reparatur deaktivieren.

Anschließend würden Sie zwei separate Updates durchführen: eine für Master-CPU und -Arbeitsspeicher und eine weitere automatische Reparatur. Prüfen Sie, ob die erste Aktualisierung erfolgreich war, bevor Sie die zweite Aktualisierung ausführen.

Aktualisierungsvorgang

Sie können gkectl, die Google Cloud Console oder die Google Cloud CLI verwenden, um einen Nutzercluster zu aktualisieren. Wenn Sie den Nutzercluster mit Terraform erstellt haben, können Sie den Cluster mit Terraform aktualisieren. In fast allen Fällen müssen Sie gkectl zum Aktualisieren von Administratorclustern verwenden.

Die folgenden Beispiele zeigen, wie Cluster aktualisiert werden.

gkectl

Der Befehl gkectl update hat eines der folgenden Formate:

Beispiel für einen Administratorcluster (gkectl update admin)

Angenommen, Sie möchten den Wert von gkeOnPremAPI.enabled in einem Administratorcluster von false in true ändern. Bearbeiten Sie zuerst die Konfigurationsdatei des Administratorclusters und legen Sie den Wert auf true fest:

gkeOnPremAPI:
  enabled: true

Aktualisieren Sie anschließend den Administratorcluster:

gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config ADMIN_CLUSTER_CONFIG

Ersetzen Sie Folgendes:

  • ADMIN_CLUSTER_KUBECONFIG: der Pfad der kubeconfig-Datei des Administratorclusters

  • ADMIN_CLUSTER_CONFIG: der Pfad Ihrer Administratorcluster-Konfigurationsdatei.

Beispiel für einen Nutzercluster (gkectl update cluster)

Angenommen, Sie möchten den Wert von stackdriver.vSphereDisableResourceMetrics in einem Nutzercluster von false in true ändern. Bearbeiten Sie zuerst die Konfigurationsdatei des Nutzerclusters und legen Sie den Wert auf true fest:

stackdriver:
  disableVsphereResourceMetrics: true

Aktualisieren Sie anschließend den Nutzercluster:

gkectl update cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config USER_CLUSTER_CONFIG

Ersetzen Sie Folgendes:

  • ADMIN_CLUSTER_KUBECONFIG: der Pfad der kubeconfig-Datei des Administratorclusters

  • USER_CLUSTER_CONFIG: der Pfad Ihrer Nutzerclusterkonfigurationsdatei.

Beispiel für einen Nutzercluster (gkectl update credentials)

Angenommen, Sie möchten die Anmeldedaten ändern, die ein Nutzercluster zum Aufrufen von vCenter Server verwendet.

Die Konfigurationsdatei des Nutzerclusters enthält das Feld vCenter.credentials.fileRef.path, das auf eine Konfigurationsdatei für Anmeldedaten verweist. Aktualisieren Sie in der Konfigurationsdatei für Anmeldedaten die Werte von username und password. Beispiel:

items:
- name: "vcenter-creds"
  username: "new-vcenter-account"
  password: "U$icUKEW#INE"

Aktualisieren Sie anschließend die Anmeldedaten:

gkectl update credentials vsphere \
    --config USER_CLUSTER_CONFIG \
    --kubeconfig ADMIN_CLUSTER_KUBECONFIG

Ersetzen Sie Folgendes:

  • USER_CLUSTER_CONFIG: der Pfad Ihrer Nutzerclusterkonfigurationsdatei

  • ADMIN_CLUSTER_KUBECONFIG: der Pfad der kubeconfig-Datei des Administratorclusters

Console

  1. Rufen Sie in der Console die Seite Google Kubernetes Engine-Cluster – Übersicht auf.

    Zu GKE-Clustern

  2. Wählen Sie das Google Cloud-Projekt und dann den Cluster aus, den Sie aktualisieren möchten.

  3. Klicken Sie im Bereich Details auf Weitere Details.

  4. Felder, die in der Google Cloud Console aktualisiert werden können, haben ein Stiftsymbol. Klicken Sie auf eines der Stiftsymbole. Ändern Sie im daraufhin angezeigten Feld die Feldwerte nach Bedarf und klicken Sie auf FERTIG.

  5. Klicken Sie oben auf der Seite in der Fortschrittsanzeige auf Details anzeigen. Warten Sie, bis das Update abgeschlossen ist.

gcloud-CLI

Führen Sie den entsprechenden Aktualisierungsbefehl aus. Geben Sie nur die Flags für die Konfiguration an, die Sie ändern möchten:

Administratoren in einem Nutzercluster aktualisieren

Der Kubernetes API-Server jedes Clusters muss in der Lage sein, empfangene Anfragen zu autorisieren. Zum Konfigurieren der Autorisierung müssen Sie auf jedem Cluster Richtlinien für die rollenbasierte Zugriffssteuerung (Role-Based Access Control, RBAC) von Kubernetes konfigurieren. Ein Administrator ist ein Nutzer, dem die Rolle cluster-admin im Nutzercluster zugewiesen wurde. Diese Rolle gewährt dem Nutzer vollen Administratorzugriff auf den Cluster.

Angenommen, Alice und Bob sind die einzigen Administratornutzer im Nutzercluster cluster-1 in der Region us-west1. Angenommen, Alice möchte Trent als zusätzlichen Administrator hinzufügen. Alice könnte den folgenden Befehl ausführen:

gcloud container vmware clusters update cluster-1 \
    --project example-project-id-12345 \
    --location us-west1 \
    --admin-users alice@example.com \
    --admin-users bob@example.com \
    --admin-users trent@example.com

Mit dem vorherigen Befehl behält Alice und Bob die Liste der Administratornutzer bei und fügt Trent der Liste der Administratornutzer hinzu. Beachten Sie, dass Alice und Bob im Befehl aufgeführt sein müssen, da der Befehl die aktuelle Liste der Administratoren mit der im Befehl angegebenen Liste überschreibt. Beachten Sie außerdem, dass jedes Flag --admin-users nur einen Nutzer angibt. Sie können nicht mehrere Nutzer in einem einzelnen Flag angeben.

Terraform

  1. Ändern Sie die Werte der anwendbaren Felder in der Terraform-Konfigurationsdatei, die Sie zum Erstellen des Clusters oder Knotenpools verwendet haben. Ausführliche Feldbeschreibungen finden Sie in der Terraform-Referenzdokumentation:

  2. Aktualisieren Sie die Konfiguration mit terraform apply.

Administratoren in einem Nutzercluster aktualisieren

Der Kubernetes API-Server jedes Clusters muss in der Lage sein, empfangene Anfragen zu autorisieren. Zum Konfigurieren der Autorisierung müssen Sie auf jedem Cluster Richtlinien für die rollenbasierte Zugriffssteuerung (Role-Based Access Control, RBAC) von Kubernetes konfigurieren. Ein Administrator ist ein Nutzer, dem die Rolle cluster-admin im Nutzercluster zugewiesen wurde. Diese Rolle gewährt dem Nutzer vollen Administratorzugriff auf den Cluster.

Angenommen, Alice und Bob sind die einzigen Administratoren in einem bestimmten Nutzercluster. Angenommen, Alice möchte Trent als zusätzlichen Administrator hinzufügen. Alice könnte die Terraform-Konfiguration so anpassen und dann terraform apply ausführen:

authorization {
  admin_users {
    username = "alice@example.com"
    username = "bob@example.com"
    username = "trent@example.com"
  }
}

Die vorherige Anpassung behält Alice und Bob in der Liste der Administratornutzer und fügt Trent der Liste der Administratornutzer hinzu. Beachten Sie, dass Alice und Bob in der neuen Konfiguration aufgeführt sein müssen, da der Befehl terraform apply die aktuelle Liste der Administratoren mit der in der Konfiguration angegebenen Liste überschreibt.

Weitere Informationen

Die in diesem Abschnitt aufgeführten Dokumente enthalten zusätzliche Details zum Aktualisieren von Clustern.

Cluster/Administrator aktualisieren

Die folgenden Dokumente enthalten Details zur Verwendung von gkectl update admin und gkectl update cluster zum Aktualisieren von Features und Einstellungen:

Anmeldedaten aktualisieren

Die folgenden Dokumente enthalten Details zur Verwendung von gkectl update credentials zum Aktualisieren von Schlüsseln und Zertifikaten:

Nächste Schritte

Cluster aktualisieren