Configurazione del progetto e del cluster GKE in autonomia

Se installi Anthos Service Mesh utilizzando asmcli, l'app può configurare il progetto e il 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é chiedere a asmcli di apportare le modifiche, segui i passaggi indicati in questa pagina.

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

Per impostazione predefinita, asmcli non installa istio-ingressgateway. Ti consigliamo di eseguire il deployment e la gestione del piano di controllo e dei gateway separatamente. Anthos Service Mesh supporta l'inserimento automatico per i deployment gateway, che semplifica gli upgrade di Anthos Service Mesh. Dopo aver eseguito l'upgrade di Anthos Service Mesh, riavvii i gateway come per i servizi per utilizzare la nuova configurazione del piano di controllo. 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 console Google Cloud.
  
  Vai alla pagina Dashboard
2. Fai clic sull'elenco a discesa nella parte superiore della pagina. Nella finestra Seleziona da visualizzata, scegli il tuo progetto.
  
  L'ID e il numero del progetto sono visualizzati nella scheda Informazioni sul progetto della dashboard del progetto.
Crea le seguenti variabili di ambiente:
- Imposta il pool di carichi di lavoro 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 IAM (Identity and Access Management) richiesti. Se sei un proprietario di progetto, disponi di tutte le autorizzazioni necessarie per completare l'installazione. Se non sei un proprietario del progetto, è necessaria una persona che ti conceda i ruoli IAM specifici riportati di seguito. Nel seguente comando, 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, questo imposta i ruoli IAM richiesti per te.

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	Descrizione
`meshconfig.googleapis.com`	Inoltra i dati di configurazione dal tuo mesh a Google Cloud. Inoltre, ti consente di accedere alle pagine Anthos Service Mesh nella console Google Cloud e di utilizzare l'autorità di certificazione Anthos Service Mesh (Mesh CA).
`meshca.googleapis.com`	API dell'autorità di certificazione Anthos Service Mesh. Consente l'utilizzo di un provider di certificati gestiti, incluso in Anthos Service Mesh. Questa API è abilitata anche se utilizzi Certificate Authority Service o CA Istio.
`container.googleapis.com`	Utilizzato per la creazione e la gestione di applicazioni basate su container, basate sulla tecnologia open source Kubernetes.
`monitoring.googleapis.com`	Gestisce i dati e le configurazioni di Cloud Monitoring. Utilizzata per archiviare la telemetria dell'applicazione visualizzata nella console Google Cloud.
`gkehub.googleapis.com`	Utilizzato per configurare l'ambito del mesh. Per saperne di più, consulta la documentazione sulla gestione del parco risorse.
`stackdriver.googleapis.com`	Utilizzato dalla suite operativa di Google Cloud per raccogliere indicatori su app, piattaforme e servizi interni ed esterni di Google Cloud.
`opsconfigmonitoring.googleapis.com`	Raccoglie, aggrega e indicizza le risorse in Google Cloud, abilitando l'UI di Anthos Service Mesh.
`connectgateway.googleapis.com`	Consente all'infrastruttura Google di connettersi in modo sicuro ai cluster GKE registrati in più cloud e ambienti ibridi.

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

Configurazione del 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 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 a livello di regione, imposta la regione predefinita:
```
gcloud config set compute/region CLUSTER_LOCATION
```
Imposta l'etichetta mesh_id sul cluster. Se nel cluster esistono già etichette che vuoi conservare, devi includerle quando aggiungi l'etichetta mesh_id.
1. Per verificare se il 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 sotto il campo resourceLabels, ad esempio:
```
resourceLabels:
  csm: ''
  env: dev
  release: stable
```
  Per praticità, puoi aggiungere le etichette a una variabile di ambiente. Nel seguente, sostituisci YOUR_EXISTING_LABELS con un elenco separato da virgole delle etichette esistenti sul tuo cluster nel formato KEY=VALUE, ad esempio: env=dev,release=stable
```
export EXISTING_LABELS="YOUR_EXISTING_LABELS"
```
2. Imposta l'etichetta mesh_id:
  - Se nel cluster esistono etichette 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, aggiorna il cluster 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 da 10 a 15 minuti.

Registra il cluster nel parco risorse.
Inizializza il progetto per prepararlo per l'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 tuo progetto. Nel seguente comando, 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: {}

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