Aggiorna i parametri del cluster Azure

Console

1. Nella Google Cloud console, vai alla pagina Panoramica dei cluster Google Kubernetes Engine.

   Vai ai cluster GKE

2. Seleziona il Google Cloud progetto in cui si trova il cluster.

3. Nell'elenco dei cluster, seleziona il nome del cluster, quindi Visualizza dettagli nel riquadro laterale.

4. Nella scheda Dettagli, seleziona edit Modifica nel campo che vuoi modificare.

   Ad esempio, per concedere privilegi amministrativi del cluster ad altri utenti, selezionare edit Modifica accanto a Utenti amministratore e inserire l'indirizzo email dell'utente.

5. Al termine delle modifiche, seleziona Fine.

gcloud

Quando aggiorni un cluster utilizzando gcloud CLI, devi sempre includere i campiCLUSTER_NAME eGOOGLE_CLOUD_LOCATION, che indicano a GKE su Azure quale cluster aggiornare. Nel comando seguente, includi solo i campi che vuoi aggiornare; rimuovi gli altri campi prima di eseguire il comando.

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 

Sostituisci quanto segue:

• CLUSTER_NAME: il nome del cluster
• GOOGLE_CLOUD_LOCATION (obbligatorio): la regione Google Cloud supportata che gestisce il cluster, ad esempio us-west1
• CLUSTER_VERSION: la nuova versione del cluster supportata
• USERNAME_LIST: un elenco separato da virgole di nomi utente, ad esempio "kai@example.com,hao@example.com,kalani@example.com". Si tratta degli indirizzi email degli utenti a cui stai concedendo i privilegi amministrativi su questo cluster. I nomi in questa impostazione sostituiranno qualsiasi elenco precedente di utenti amministratore nel cluster.
• CLIENT_NAME: il tuo AzureClient
• VM_SIZE: la nuova dimensione VM supportata

Per aggiornare l'autenticazione del cluster da AzureClient a federazione delle identità per i carichi di lavoro, esegui il seguente comando:

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

API

Quando aggiorni un cluster utilizzando l'API GKE Multi-Cloud, devi sempre includere i campiCLUSTER_NAME eGOOGLE_CLOUD_LOCATION nella richiesta HTTP. Questi campi indicano a GKE su Azure quale cluster aggiornare. Devi anche includere l'endpoint API nella richiesta. Crea un file JSON con i campi da aggiornare. Includi solo i campi che vuoi aggiornare nel file JSON e in UPDATE_MASK.

Il seguente esempio mostra come aggiornare il cluster tramite l'API. Per ulteriori informazioni, incluso l'elenco dei campi che puoi aggiornare, consulta la documentazione del metodo projects.locations.azureClusters.patch.

1. Crea un file JSON denominato cluster_update.json con i campi che vuoi aggiornare.

   • Quando utilizzi la federazione delle identità per i carichi di lavoro, il file JSON dovrebbe avere il seguente aspetto:

     {
       "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
               }
           ]
       }
     }
     

   • Quando utilizzi il client Azure, il file JSON dovrebbe avere il seguente aspetto:

     {
       "description": "CLUSTER_DESCRIPTION",
       "controlPlane": {
         "version": "CLUSTER_VERSION",
         "vm_size": "VM_SIZE
       },
       "azureClient": "CLIENT_NAME",
       "authorization": {
           "adminUsers": [
               {
               "username": USERNAME1,
               "username": USERNAME2,
               "username": USERNAME3
               }
           ]
       }
     }
     

   Sostituisci quanto segue:

   • CLUSTER_VERSION: la nuova versione del cluster supportata. Tieni presente che devi eseguire l'upgrade di tutte le versioni secondarie durante l'upgrade del cluster
   • CLUSTER_DESCRIPTION: la descrizione del nuovo cluster
   • USERNAME1,USERNAME2,USERNAME3: gli indirizzi email degli utenti a cui granti i privilegi amministrativi su questo cluster. I nomi in questi campi sostituiranno qualsiasi elenco precedente di utenti amministratore nel cluster.
   • CLIENT_NAME: il nome del tuo AzureClient
   • TENANT_ID: l'ID tenant Azure
   • APPLICATION_ID: l'ID applicazione Azure creato in Creare un'applicazione Azure Active Directory
   • VM_SIZE: la nuova dimensione della VM

2. Aggiorna queste impostazioni tramite l'API GKE Multi-Cloud con il seguente comando.

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

Sostituisci quanto segue:

• ENDPOINT (obbligatorio): il tuo Google Cloud endpoint del servizio
• PROJECT_ID (obbligatorio): il tuo Google Cloud progetto
• GOOGLE_CLOUD_LOCATION (obbligatorio): la regione Google Cloud supportata che gestisce il cluster, ad esempio us-west1
• CLUSTER_NAME (obbligatorio): il nome del cluster
• UPDATE_MASK (obbligatorio): un elenco separato da virgole di uno o più dei seguenti flag, che indica i campi da aggiornare. In questo esempio, specifica quanto segue.
  • controlPlane.version
  • description
  • authorization.admin_users
  • control_plane.vm_size
  • azure_client
  • azure_services_authentication.tenant_id
  • azure_services_authentication.application_id

Per aggiornare l'autenticazione del cluster da AzureClient a federazione delle identità per i carichi di lavoro, aggiungi azure_client, azure_services_authentication.tenant_id e azure_services_authentication.application_id nel campo update_mask.