Anthos Service Mesh e Traffic Director sono ora Cloud Service Mesh. Per saperne di più, consulta la panoramica di Cloud Service Mesh.

Configura il progetto e il cluster GKE in autonomia

Nota: questa guida supporta solo Cloud Service Mesh con le API Istio e non supporta le API Google Cloud . Per ulteriori informazioni, consulta la panoramica di Cloud Service Mesh.

Quando installi Cloud Service Mesh utilizzando asmcli, questo strumento può configurare il progetto e il cluster GKE su Google Cloud se includi il flag --enable_all o i flag di abilitazione più granulari. Se preferisci eseguire la configurazione autonomamente anziché lasciare che asmcli apporti 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 all'ultima versione di Cloud Service Mesh.

Per impostazione predefinita, asmcli non installa istio-ingressgateway. Ti consigliamo di eseguire il deployment e gestire separatamente il control plane e i gateway. Cloud Service Mesh supporta l'inserimento automatico per i deployment del gateway, il che semplifica gli upgrade di Cloud Service Mesh. Dopo l'upgrade di Cloud Service Mesh, riavvia i gateway proprio come i servizi al fine di recuperare la nuova configurazione del control plane. Per ulteriori informazioni, consulta Installazione e upgrade dei gateway.

Prima di iniziare

Configura il progetto

Recupera l'ID 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 consoleGoogle Cloud .
  
  Vai alla pagina Dashboard
2. Fai clic sull'elenco a discesa nella parte superiore della pagina. Nella finestra Seleziona da che compare, seleziona il tuo progetto.
  
  L'ID e il numero del progetto vengono visualizzati nella scheda Informazioni sul progetto della dashboard.
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 di progetto:
```
export MESH_ID="proj-PROJECT_NUMBER"
```
Imposta i ruoli Identity and Access Management (IAM) richiesti. Se hai il ruolo Project Owner , disponi di tutte le autorizzazioni necessarie per completare l'installazione. Se non hai il ruolo Project Owner, devi chiedere a qualcuno che lo sia di concederti 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.

Abilita le API di Google richieste:

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

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

API	Finalità	Può essere disabilitata
`meshconfig.googleapis.com`	Cloud Service Mesh utilizza l'API Mesh Configuration per trasmettere i dati di configurazione dal 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`	Obbligatoria per creare cluster Google Kubernetes Engine (GKE).	No
`gkehub.googleapis.com`	Obbligatoria per gestire il mesh come parco risorse.	No
`monitoring.googleapis.com`	Obbligatoria per acquisire la telemetria per i workload del mesh.	No
`stackdriver.googleapis.com`	Obbligatoria per utilizzare l'interfaccia utente dei servizi.	No
`opsconfigmonitoring.googleapis.com`	Obbligatoria per utilizzare l'interfaccia utente dei servizi per i cluster esterni aGoogle Cloud .	No
`connectgateway.googleapis.com`	Obbligatoria per consentire al control plane Cloud Service Mesh gestito di accedere ai workload del mesh.	Sì*
`trafficdirector.googleapis.com`	Consente un control plane gestito ad alta affidabilità e molto scalabile.	Sì*
`networkservices.googleapis.com`	Consente un control plane gestito ad alta affidabilità e molto scalabile.	Sì*
`networksecurity.googleapis.com`	Consente un control plane gestito ad alta affidabilità e molto scalabile.	Sì*

L'abilitazione delle API può richiedere un minuto o più. Quando le API sono abilitate, visualizzi 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.

Configura il cluster

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

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 di 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
```
Imposta l' etichetta mesh_id sul cluster. Se il cluster ha etichette esistenti che vuoi conservare, devi includerle quando aggiungi l'etichetta mesh_id.
1. Per verificare se nel cluster esistono etichette:
```
gcloud container clusters describe CLUSTER_NAME \
    --project PROJECT_ID
```
  Cerca il campo resourceLabels nell'output. Ogni etichetta viene memorizzata 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 codice seguente, sostituisci YOUR_EXISTING_LABELS con un elenco separato da virgole delle etichette esistenti nel cluster 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 ha etichette esistenti che vuoi conservare, aggiorna il cluster 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 solo con l'etichetta mesh_id:
```
gcloud container clusters update CLUSTER_NAME \
    --project=PROJECT_ID \
    --update-labels=mesh_id=${MESH_ID}
```

Abilita Workload Identity:

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

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

Registra il cluster nel parco risorse.
Inizializza il progetto per prepararlo all'installazione. Tra le altre cose, questo comando crea un service account per consentire ai componenti del piano dati, ad esempio il proxy sidecar, di accedere in modo sicuro ai dati e alle risorse del tuo 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 comando seguente. In caso contrario, riceverai un codice di errore causato da 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: {}

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 ora sono pronti per una nuova installazione utilizzando asmcli.

Passaggi successivi

Installa gli strumenti dipendenti e convalida il cluster