Azure-Clusterparameter aktualisieren

Console

1. Rufen Sie in der Google Cloud Console die Seite Google Kubernetes Engine-Cluster auf.

   Zu GKE-Clustern

2. Wählen Sie das Google Cloud Projekt aus, in dem sich der Cluster befindet.

3. Wählen Sie in der Clusterliste den Namen des Clusters und dann in der Seitenleiste Details ansehen aus.

4. Wählen Sie auf dem Tab Details im Feld, das Sie ändern möchten, die Option edit Bearbeiten aus.

   Wenn Sie beispielsweise anderen Nutzern Cluster-Administratorberechtigungen erteilen möchten, wählen Sie neben Administratornutzer die Option edit Bearbeiten aus und geben Sie die E-Mail-Adresse des Nutzers ein.

5. Wenn Sie alle Änderungen vorgenommen haben, wählen Sie Fertig aus.

gcloud

Wenn Sie einen Cluster mit der gcloud CLI aktualisieren, müssen Sie immer die Felder CLUSTER_NAME und GOOGLE_CLOUD_LOCATION angeben. Sie geben damit an, welcher Cluster aktualisiert werden soll. Geben Sie im folgenden Befehl nur die Felder an, 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 Identitätsföderation von Arbeitslasten umzustellen:

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 die Felder CLUSTER_NAME und GOOGLE_CLOUD_LOCATION immer in die HTTP-Anfrage aufnehmen. Anhand dieser Felder wird GKE on Azure mitgeteilt, welcher Cluster aktualisiert werden soll. Außerdem muss der API-Endpunkt in der Anfrage enthalten sein. Sie erstellen eine JSON-Datei mit den Feldern, die Sie aktualisieren möchten. Fügen Sie in der JSON-Datei und im UPDATE_MASK nur die Felder ein, die Sie aktualisieren möchten.

Im folgenden Beispiel wird gezeigt, wie Sie Ihren Cluster über die API aktualisieren. Weitere Informationen, einschließlich einer Liste der Felder, die Sie aktualisieren können, finden Sie in der Dokumentation zur Methode projects.locations.azureClusters.patch.

1. Erstellen Sie eine JSON-Datei mit dem Namen cluster_update.json und den Feldern, die Sie aktualisieren möchten.

   • Wenn Sie die Workload Identity-Föderation verwenden, 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
               }
           ]
       }
     }
     

   • Wenn Sie den Azure-Client verwenden, 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 Azure-Clients
   • TENANT_ID: Azure-Mandanten-ID
   • APPLICATION_ID: die Azure-Anwendungs-ID, die unter Azure Active Directory-Anwendung erstellen erstellt wurde
   • VM_SIZE: die neue VM-Größe

2. 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 mit einem oder mehreren der folgenden Flags, die angeben, 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 Identitätsföderation von Arbeitslasten aktualisieren möchten, fügen Sie azure_client, azure_services_authentication.tenant_id und azure_services_authentication.application_id in das Feld update_mask ein.