Diese Dokumentation bezieht sich auf die neueste Version von GKE on Azure, die im November 2021 veröffentlicht wurde. Weitere Informationen finden Sie in den Versionshinweisen.

Azure-Clusterparameter aktualisieren

Auf dieser Seite wird beschrieben, wie Sie die Einstellungen Ihres GKE on Azure-Clusters aktualisieren. Anhand dieser Anleitung können Sie alle aktualisierbaren Einstellungen in Ihrem Cluster aktualisieren, einschließlich der Kubernetes-Version. Da das Upgrade der Version einer der am häufigsten verwendeten Clusteraktualisierungsvorgänge ist, wird auf einer separaten Seite Cluster upgraden beschrieben, wie Sie ein Upgrade einer Clusterversion durchführen.

Gründe für ein Update eines Clusters

Sie können einen Cluster aus einem der folgenden Gründe aktualisieren:

So aktualisieren Sie die Beschreibung des Clusters.
So aktualisieren Sie die Annotationen des Clusters:
So aktualisieren Sie die Liste der Nutzer mit Administratorzugriff Ihres Clusters.
Aktualisieren der Logging-Konfiguration Ihres Clusters.
Um die VM-Größe des Clusters zu aktualisieren.
So aktualisieren Sie den AzureClient Ihres Clusters.
So aktualisieren Sie die Authentifizierung Ihres Clusters von AzureClient auf die Workload Identity-Föderation.

Sie können auch andere Felder in Ihren Clustern aktualisieren, die hier nicht aufgeführt sind. Eine vollständige Liste der Felder, die Sie aktualisieren können, finden Sie in der Dokumentation zu gcloud container azure clusters update und projects.locations.azureClusters.patch.

Vorbereitung

Sie benötigen die IAM-Berechtigung gkemulticloud.googleapis.com/azureClusters.update (Identity and Access Management), um Felder des Clusters zu aktualisieren.

Der Aktualisierungsvorgang

Wie ein Cluster von GKE on Azure aktualisiert wird, hängt von der Art der Aktualisierung ab. Bei einigen Änderungen kann GKE on Azure einen Cluster aktualisieren, ohne dass ein Neustart durchgeführt oder Ressourcen neu erstellt werden müssen, z. B. durch Aktualisieren der Beschreibung eines Clusters. GKE on Azure nimmt diese Änderungen sofort vor.

Andere Änderungen erfordern einen Neustart der Steuerungsebenenknoten, z. B. beim Aktualisieren der VM-Größe oder der Kubernetes-Version. Für solche Updates führt GKE on Azure ein „Rolling Update“ aus, das aus den folgenden Schritten besteht:

Wählen Sie eine Instanz der Steuerungsebene aus, die aktualisiert werden soll. GKE on Azure aktualisiert fehlerhafte Instanzen vor fehlerfreien Instanzen, sofern vorhanden.
Löschen Sie die Instanz. GKE on Azure erstellt die Instanz neu und sie startet mit der neuen Konfiguration.
Führen Sie Systemdiagnosen für die Instanz durch.
Wenn die Systemdiagnosen erfolgreich sind, wählen Sie eine andere Instanz aus und führen Sie dieselben Schritte für sie aus. Wiederholen Sie diesen Zyklus, bis alle Instanzen neu gestartet oder neu erstellt wurden. Wenn die Systemdiagnose fehlschlägt, setzt GKE on Azure den Cluster in den Status DEGRADED und stoppt das Update. Weitere Informationen finden Sie im folgenden Abschnitt:

Wenn ein Update fehlschlägt

Nach einem Update führt GKE on Azure eine Systemdiagnose für den Cluster durch. Wenn die Systemdiagnose fehlschlägt, wird der Cluster als DEGRADED markiert. Sie können den Status des Clusters mit dem folgenden Befehl der Google Cloud CLI aufrufen:

gcloud container azure clusters describe CLUSTER_NAME \
  --location=GOOGLE_CLOUD_LOCATION

Ersetzen Sie Folgendes:

CLUSTER_NAME: der Name Ihres Clusters
GOOGLE_CLOUD_LOCATION: die Google Cloud-Region, die Ihren Cluster verwaltet

Cluster aktualisieren

Sie können entweder die Google Cloud Console, die Google Cloud CLI oder die GKE Multi-Cloud API verwenden, um mehrere Clusterfelder gleichzeitig zu aktualisieren.

Aktualisierungsmethode auswählen

Sie können die meisten Felder über die Console, die gcloud CLI oder die GKE Multi-Cloud API aktualisieren. Einige Felder können nur über einen der Mechanismen aktualisiert werden. Wenn Sie die Console zum Aktualisieren eines Clusters verwenden möchten, müssen Sie zuerst eine Authentifizierungsmethode für die Anmeldung beim Cluster auswählen und konfigurieren. Weitere Informationen finden Sie unter Verbindung zum Cluster herstellen und authentifizieren.

Console

Rufen Sie in der Google Cloud Console die Seite Übersicht über Google Kubernetes Engine-Cluster auf.

Zu GKE-Clustern
Wählen Sie das Google Cloud-Projekt aus, in dem sich der Cluster befindet.
Wählen Sie in der Clusterliste den Namen des Clusters aus und wählen Sie dann in der Seitenleiste Details ansehen aus.
Wählen Sie auf dem Tab Details bei dem Feld, das Sie ändern möchten, die Option Bearbeiten aus.

Wenn Sie anderen Nutzern beispielsweise Administratorberechtigungen für den Cluster gewähren möchten, wählen Sie neben Administratornutzer Bearbeiten aus und geben Sie die E-Mail-Adresse des Nutzers ein.
Wenn Sie alle Änderungen vorgenommen haben, wählen Sie Fertig aus.

gcloud

Wenn Sie einen Cluster über die gcloud CLI aktualisieren, müssen Sie immer die Felder CLUSTER_NAME und GOOGLE_CLOUD_LOCATION angeben. Diese teilen GKE on Azure mit, welcher Cluster aktualisiert werden soll. Fügen Sie in den folgenden Befehl nur die Felder ein, die Sie aktualisieren möchten. Entfernen Sie die anderen Felder, bevor Sie den Befehl ausführen.

gcloud container azure clusters update CLUSTER_NAME \
    --location=GOOGLE_CLOUD_LOCATION \
    --cluster-version=CLUSTER_VERSION \
    --admin-users=USERNAME_LIST \
    --client=CLIENT_NAME \
    --vm-size=VM_SIZE

Ersetzen Sie Folgendes:

CLUSTER_NAME: der Name Ihres Clusters
GOOGLE_CLOUD_LOCATION (erforderlich): die unterstützte Google Cloud-Region, die Ihren Cluster verwaltet, z. B. us-west1
CLUSTER_VERSION: die neue unterstützte Clusterversion.
USERNAME_LIST: eine durch Kommas getrennte Liste von Nutzernamen, z. B. „kai@beispiel.de,hao@beispiel.de,kalani@beispiel.de“. Dies sind die E-Mail-Adressen der Nutzer, denen Sie Administratorberechtigungen für diesen Cluster gewähren. Die Namen in diesem Feld ersetzen alle vorherigen Listen von Administratornutzern für den Cluster.
CLIENT_NAME: Ihr AzureClient
VM_SIZE: die neue unterstützte VM-Größe

Führen Sie den folgenden Befehl aus, um die Authentifizierung des Clusters von AzureClient auf die Workload Identity-Föderation zu aktualisieren:

gcloud container azure clusters update CLUSTER_NAME \
    --location=GOOGLE_CLOUD_LOCATION \
    --azure-tenant-id="${TENANT_ID}" \
    --azure-application-id="${APPLICATION_ID}" \
    --clear-client

API

Wenn Sie einen Cluster mit der GKE Multi-Cloud API aktualisieren, müssen Sie in der HTTP-Anfrage immer die Felder CLUSTER_NAME und GOOGLE_CLOUD_LOCATION angeben. Diese Felder teilen GKE on Azure mit, welcher Cluster aktualisiert werden soll. Sie müssen auch den API-Endpunkt in die Anfrage aufnehmen. Sie erstellen eine JSON-Datei mit den Feldern, die Sie aktualisieren möchten. Geben Sie nur die Felder an, die Sie in der JSON-Datei und im UPDATE_MASK aktualisieren möchten.

Das folgende Beispiel zeigt, wie Sie Ihren Cluster über die API aktualisieren. Weitere Informationen, einschließlich einer Liste der Felder, die aktualisiert werden können, finden Sie in der Dokumentation zur Methode projects.locations.azureClusters.patch.

Erstellen Sie eine JSON-Datei mit dem Namen cluster_update.json und den Feldern, die Sie aktualisieren möchten.
- Bei Verwendung der Workload Identity-Föderation sollte die JSON-Datei so aussehen:
```
{
  "description": "CLUSTER_DESCRIPTION",
  "controlPlane": {
    "version": "CLUSTER_VERSION",
    "vm_size": "VM_SIZE
  },
  "azureServicesAuthentication": {
    "tenantId": "TENANT_ID",
    "applicationId": "APPLICATION_ID"
  },
  "authorization": {
      "adminUsers": [
          {
          "username": USERNAME1,
          "username": USERNAME2,
          "username": USERNAME3
          }
      ]
  }
}
```
- Bei Verwendung des Azure-Clients sollte die JSON-Datei so aussehen:
```
{
  "description": "CLUSTER_DESCRIPTION",
  "controlPlane": {
    "version": "CLUSTER_VERSION",
    "vm_size": "VM_SIZE
  },
  "azureClient": "CLIENT_NAME",
  "authorization": {
      "adminUsers": [
          {
          "username": USERNAME1,
          "username": USERNAME2,
          "username": USERNAME3
          }
      ]
  }
}
```
Ersetzen Sie Folgendes:
- CLUSTER_VERSION: die neue unterstützte Clusterversion. Sie müssen beim Upgrade des Clusters alle Nebenversionen aktualisieren.
- CLUSTER_DESCRIPTION: die neue Clusterbeschreibung
- USERNAME1,USERNAME2,USERNAME3: die E-Mail-Adressen der Nutzer, denen Sie Administratorberechtigungen für diesen Cluster gewähren. Die Namen in diesen Feldern ersetzen alle vorherigen Listen von Administratornutzern für den Cluster.
- CLIENT_NAME: der Name Ihres AzureClient
- TENANT_ID: die Azure-Mandanten-ID
- APPLICATION_ID: die ID der Azure-Anwendung, die unter Azure Active Directory-Anwendung erstellen erstellt wurde.
- VM_SIZE: die neue VM-Größe

Aktualisieren Sie diese Einstellungen über die GKE Multi-Cloud API mit dem folgenden Befehl.

curl -d @cluster_update.json -X PATCH \
   ENDPOINT/projects/PROJECT_ID/locations/GOOGLE_CLOUD_LOCATION/azureClusters/CLUSTER_NAME?update_mask=UPDATE_MASK

Ersetzen Sie Folgendes:

ENDPOINT (erforderlich): Ihr Google Cloud-Dienstendpunkt
PROJECT_ID (erforderlich): Ihr Google Cloud-Projekt
GOOGLE_CLOUD_LOCATION (erforderlich): die unterstützte Google Cloud-Region, die Ihren Cluster verwaltet, z. B. us-west1
CLUSTER_NAME (erforderlich): Ihr Clustername
UPDATE_MASK (erforderlich): eine durch Kommas getrennte Liste eines oder mehrerer der folgenden Flags, die angibt, welche Felder aktualisiert werden sollen. Geben Sie in diesem Beispiel Folgendes an.
- controlPlane.version
- description
- authorization.admin_users
- control_plane.vm_size
- azure_client
- azure_services_authentication.tenant_id
- azure_services_authentication.application_id

Wenn Sie die Authentifizierung des Clusters von AzureClient auf die Workload Identity-Föderation aktualisieren möchten, fügen Sie azure_client, azure_services_authentication.tenant_id und azure_services_authentication.application_id in das Feld update_mask hinzu.

Logging-Konfiguration aktualisieren

Sie können die Cloud Logging-Konfigurationseinstellungen des Clusters mit der Google Cloud CLI aktualisieren. Führen Sie folgenden Befehl aus, um die Logging-Konfiguration zu aktualisieren:

gcloud container azure clusters update CLUSTER_NAME \
    --location=GOOGLE_CLOUD_LOCATION \
    --logging=LOGGING_CONFIG \

Ersetzen Sie Folgendes:

CLUSTER_NAME: der Name des Clusters
GOOGLE_CLOUD_LOCATION: die unterstützte Google Cloud-Region, die Ihren Cluster verwaltet, z. B. us-west1
LOGGING_CONFIG: [SYSTEM] oder [SYSTEM,WORKLOAD]

Nächste Schritte

Informationen zum Aktualisieren von KMS-Schlüsseln in Volumes finden Sie unter Schlüsselrotation.
Weitere Informationen zu aktualisierbaren Feldern finden Sie in der Referenzdokumentation zu gcloud container azure clusters update.
Siehe REST-Dokumentation zu projects.locations.azureClusters.patch.