Configurazione del progetto e del cluster GKE in autonomia

Per ulteriori informazioni, consulta la panoramica di Cloud Service Mesh.

Quando installi Cloud Service Mesh utilizzando asmcli, può configurare il tuo progetto e il tuo cluster GKE su Google Cloud per te se includi il flag --enable_all o i flag di abilitazione più granulari. Se preferisci eseguire la configurazione autonomamente anziché lasciare che sia asmcli a apportare le modifiche, segui i passaggi descritti in questa pagina.

Se hai già installato una versione precedente di Cloud Service Mesh, non devi apportare modifiche al progetto o al cluster prima di utilizzare asmcli per eseguire l'upgrade alla versione più recente di Cloud Service Mesh.

Per impostazione predefinita, asmcli non installa istio-ingressgateway. Ti consigliamo di eseguire il deployment e gestire il piano di controllo e i gateway separatamente. Cloud Service Mesh supporta l'iniezione automatica per i deployment dei gateway, il che semplifica gli upgrade di Cloud Service Mesh. Dopo l'upgrade di Cloud Service Mesh, riavvia i gateway come faresti con i servizi per acquisire la nuova configurazione del piano di controllo. Per ulteriori informazioni, consulta Installare e eseguire l'upgrade dei gateway.

Avviso: durante gli upgrade, asmcli rimuove istio-ingressgateway predefinito dall'

spazio dei nomi istio-system. Se hai bisogno del valore predefinito istio-ingressgateway installato con il piano di controllo in-cluster, includi l'argomento --option legacy-default-ingressgateway.

Prima di iniziare

• Esamina i prerequisiti e i requisiti
• Pianificare l'installazione o l'upgrade
• Installare gli strumenti richiesti

Configura il progetto

1. Recupera l'ID progetto e il numero del progetto in cui è stato creato il cluster.

   gcloud

   Esegui questo comando:

   gcloud projects list
   

   Console

   1. Vai alla pagina Dashboard nella console Google Cloud.

      Vai alla pagina Dashboard

   2. Fai clic sull'elenco a discesa nella parte superiore della pagina. Nella finestra Seleziona da visualizzata, seleziona il tuo progetto.

      L'ID e il numero del progetto vengono visualizzati nella scheda Informazioni sul progetto della dashboard del progetto.

2. Crea le seguenti variabili di ambiente:

   • Imposta il pool di workload utilizzando l'ID progetto:

     export WORKLOAD_POOL=PROJECT_ID.svc.id.goog
     

   • Imposta l'ID mesh utilizzando il numero del progetto:

     export MESH_ID="proj-PROJECT_NUMBER"
     

3. Imposta i ruoli IAM (Identity and Access Management) richiesti. Se sei un proprietario del progetto, disponi di tutte le autorizzazioni necessarie per completare l'installazione. Se non sei un proprietario del progetto, devi avere un utente che ti conceda i seguenti ruoli IAM specifici. Nel comando seguente, sostituisci PROJECT_ID con l'ID progetto del passaggio precedente e GCP_EMAIL_ADDRESS con l'account che utilizzi per accedere a Google Cloud.

   ROLES=(
   'roles/servicemanagement.admin' \
   'roles/serviceusage.serviceUsageAdmin' \
   'roles/meshconfig.admin' \
   'roles/compute.admin' \
   'roles/container.admin' \
   'roles/resourcemanager.projectIamAdmin' \
   'roles/iam.serviceAccountAdmin' \
   'roles/iam.serviceAccountKeyAdmin' \
   'roles/gkehub.admin')
   for role in "${ROLES[@]}"
   do
     gcloud projects add-iam-policy-binding PROJECT_ID \
       --member "user:GCP_EMAIL_ADDRESS" \
       --role="$role"
   done
   

   Se includi il flag --enable_all o --enable_gcp_iam_roles quando esegui asmcli, vengono impostati i ruoli IAM richiesti.

4. Abilita le API Google richieste:

   gcloud services enable \
       --project=PROJECT_ID \
       mesh.googleapis.com
   

   Oltre a mesh.googleapis.com, questo comando abilita anche le seguenti API:

   Nota: alcune API richieste hanno dipendenze transitorie da altre API.

   API	Finalità	Può essere disattivato
   meshconfig.googleapis.com	Cloud Service Mesh utilizza l'API Mesh Configuration per inoltrare i dati di configurazione dal tuo mesh a Google Cloud. Inoltre, l'abilitazione dell'API Mesh Configuration ti consente di accedere alle pagine di Cloud Service Mesh nella console Google Cloud e di utilizzare l'autorità di certificazione Cloud Service Mesh.	No
   meshca.googleapis.com	Relativa all'autorità di certificazione Cloud Service Mesh utilizzata da Cloud Service Mesh gestito.	No
   container.googleapis.com	Obbligatorio per creare cluster Google Kubernetes Engine (GKE).	No
   gkehub.googleapis.com	Obbligatorio per gestire il mesh come parco risorse.	No
   monitoring.googleapis.com	Obbligatorio per acquisire la telemetria per i carichi di lavoro mesh.	No
   stackdriver.googleapis.com	Obbligatorio per utilizzare l'interfaccia utente dei servizi.	No
   opsconfigmonitoring.googleapis.com	Obbligatorio per utilizzare l'interfaccia utente dei servizi per i cluster esterni a Google Cloud.	No
   connectgateway.googleapis.com	Obbligatorio affinché il control plane di Cloud Service Mesh gestito possa accedere ai carichi di lavoro di mesh.	Sì*
   trafficdirector.googleapis.com	Consente un piano di controllo gestito altamente disponibile e scalabile.	Sì*
   networkservices.googleapis.com	Consente un piano di controllo gestito altamente disponibile e scalabile.	Sì*
   networksecurity.googleapis.com	Consente un piano di controllo gestito altamente disponibile e scalabile.	Sì*

   Avviso: la disattivazione di connectgateway.googleapis.com, trafficdirector.googleapis.com, networkservices.googleapis.com e/o networksecurity.googleapis.com fa smettere di funzionare il piano di controllo gestito di Cloud Service Mesh. Se il parco risorse non utilizza Cloud Service Mesh gestito su nessun cluster, queste API possono essere disattivate.

   L'attivazione delle API può richiedere un minuto o più. Quando le API sono attivate, viene visualizzato un output simile al seguente:

   Operation "operations/acf.601db672-88e6-4f98-8ceb-aa3b5725533c" finished
   successfully.
   

   Se includi il flag --enable_all o --enable_apis quando esegui asmcli, le API richieste vengono abilitate automaticamente.

Configurazione del cluster

Se includi il flag --enable_all o uno dei flag di attivazione più granulari, asmcli configura il cluster per te.

1. Imposta la zona o la regione predefinita per Google Cloud CLI. Se non imposti il valore predefinito qui, assicurati di specificare l'opzione --zone o --region nei comandi gcloud container clusters in questa pagina.

   • Se hai un cluster a zona singola, imposta la zona predefinita:

     gcloud config set compute/zone CLUSTER_LOCATION
     

   • Se hai un cluster regionale, imposta la regione predefinita:

     gcloud config set compute/region CLUSTER_LOCATION
     

2. Imposta l'mesh_id etichetta sul cluster. Se il cluster contiene etichette esistenti che vuoi conservare, devi includerle quando aggiungi l'etichetta mesh_id.

   1. Per verificare se il tuo cluster ha etichette esistenti:

      gcloud container clusters describe CLUSTER_NAME \
          --project PROJECT_ID
      

      Cerca il campo resourceLabels nell'output. Ogni etichetta viene archiviata in una riga separata nel campo resourceLabels, ad esempio:

      resourceLabels:
        csm: ''
        env: dev
        release: stable

      Per comodità, puoi aggiungere le etichette a una variabile di ambiente. Nel testo che segue, sostituisci YOUR_EXISTING_LABELS con un elenco delle etichette esistenti nel cluster separato da virgole nel formato KEY=VALUE, ad esempio:env=dev,release=stable

      export EXISTING_LABELS="YOUR_EXISTING_LABELS"
      

   2. Imposta l'etichetta mesh_id:

      • Se il cluster contiene etichette esistenti che vuoi conservare, aggiornalo con mesh_id e le etichette esistenti:

        gcloud container clusters update CLUSTER_NAME \
            --project PROJECT_ID \
            --update-labels=mesh_id=${MESH_ID},${EXISTING_LABELS}
        

      • Se il cluster non ha etichette esistenti, aggiornalo con solo l'etichetta mesh_id:

        gcloud container clusters update CLUSTER_NAME \
            --project=PROJECT_ID \
            --update-labels=mesh_id=${MESH_ID}
        

3. Attiva Workload Identity:

   gcloud container clusters update CLUSTER_NAME \
       --project=PROJECT_ID \
       --workload-pool=${WORKLOAD_POOL}
   

   L'attivazione di Workload Identity può richiedere fino a 10-15 minuti.

4. Registra il cluster nel parco risorse.

5. Inizializza il progetto per prepararlo all'installazione. Tra le altre cose, questo comando crea un account di servizio per consentire ai componenti del piano dati, come il proxy sidecar, di accedere in modo sicuro ai dati e alle risorse del progetto. Nel comando seguente, sostituisci FLEET_PROJECT_ID con il progetto host del parco risorse:

   Avviso: se FLEET_PROJECT_ID è uguale a PROJECT_ID, rimuovi "FLEET_PROJECT_ID.hub.id.goog", dal seguente comando. In caso contrario, riceverai un codice di errore a causa di INVALID_ARGUMENT.

   curl --request POST  \
    --header "Authorization: Bearer $(gcloud auth print-access-token)" \
    --header "Content-Type: application/json" \
    --data '{"workloadIdentityPools":["FLEET_PROJECT_ID.hub.id.goog","FLEET_PROJECT_ID.svc.id.goog","PROJECT_ID.svc.id.goog"]}' \
    "https://meshconfig.googleapis.com/v1alpha1/projects/PROJECT_ID:initialize"
   

   Il comando risponde con parentesi graffe vuote: {}

6. Abilita Cloud Monitoring e Cloud Logging su GKE:

   gcloud container clusters update CLUSTER_NAME \
       --project=PROJECT_ID \
       --enable-stackdriver-kubernetes
   

Il progetto e il cluster sono ora pronti per una nuova installazione utilizzando asmcli.

Passaggi successivi

• Installa gli strumenti dipendenti e convalida il cluster