Stai visualizzando la documentazione di Service Mesh 1.21.

Versioni disponibili

Cloud Service Mesh
Archivio 1.22
Archivio 1.21
Archivio 1.20
Archivio 1.19
Archivio 1.18

Questa pagina è stata tradotta dall'API Cloud Translation.

Installa Cloud Service Mesh per i carichi di lavoro Kubernetes fuori da Google Cloud

Questa pagina spiega come installare Cloud Service Mesh nel cluster non gestito per i carichi di lavoro Kubernetes al di fuori di Google Cloud:

Esegui asmcli per eseguire una nuova installazione di Cloud Service Mesh 1.21.5-asm.12.
Facoltativamente, esegui il deployment di un gateway in entrata.
Esegui il deployment o riesegui il deployment dei carichi di lavoro per inserire proxy sidecar.

Se devi installare Cloud Service Mesh non gestito e in-cluster con istiod su GKE, vedi Installa Cloud Service Mesh nel cluster su Google Cloud. Tieni presente che, per i carichi di lavoro Kubernetes Google Cloud, il provisioning di un piano di controllo gestito

Per istruzioni su come preparare un'installazione offline di Cloud Service Mesh: vedi Prepara un'installazione offline di Cloud Service Mesh Durante l'esecuzione, dovrai specificare le opzioni --offline e --output_dir asmcli install.

Limitazioni

Nota. Vi sono delle limitazioni:

Tutti i cluster Cloud Service Mesh per un mesh devono essere registrati nella stessa rete per utilizzare Cloud Service Mesh. Altri cluster in di un cluster Cloud Service Mesh non deve essere registrato un parco risorse diverso.
Lo strumento asmcli deve avere accesso all'endpoint Google Kubernetes Engine (GKE). Puoi configurare l'accesso tramite una "jump" server, ad esempio un VM di Compute Engine all'interno del Virtual Private Cloud (VPC) che fornisce l'accesso.

Prima di iniziare

Prima di iniziare, assicurati di:

Esamina i prerequisiti.
Esamina le informazioni riportate in Pianificare l'installazione.
Installa gli strumenti necessari.
Scarica asmcli.
Concedi le autorizzazioni di amministratore del cluster.
Convalida progetto e cluster.

Ruoli richiesti per installare Cloud Service Mesh nel cluster

La tabella seguente descrive i ruoli necessari per installare Cloud Service Mesh nel cluster.

Nome del ruolo	ID ruolo	Posizione concessione	Descrizione
Amministratore GKE Hub	roles/gkehub.admin	Progetto parco risorse	Accesso completo a GKE Hub e alle risorse correlate.
Kubernetes Engine Admin	roles/container.admin	Progetto cluster. Tieni presente che questo ruolo deve essere concesso sia nel progetto del parco risorse sia nel progetto del cluster per le associazioni tra progetti.	Fornisce l'accesso alla gestione completa dei cluster di container e dei loro oggetti API di Kubernetes.
Mesh Config Admin	roles/meshconfig.admin	Progetto di parco risorse e cluster	Fornisce le autorizzazioni necessarie per inizializzare i componenti gestiti di Cloud Service Mesh, come l'autorizzazione di backend e piano di controllo gestito che consente ai carichi di lavoro di comunicare con Stackdriver con autorizzazione individuale (per i piani di controllo gestiti e in-cluster).
Amministratore IAM progetto	roles/resourcemanager.projectIamAdmin	Progetto cluster	Fornisce le autorizzazioni per amministrare i criteri IAM nei progetti.
Amministratore account di servizio	roles/iam.serviceAccountAdmin	Progetto parco risorse	Autentica come account di servizio.
Amministratore Service Management	roles/servicemanagement.admin	Progetto parco risorse	Controllo completo delle risorse Google Service Management.
Amministratore Service Usage	roles/serviceusage.serviceUsageAdmin	Progetto parco risorse	Può abilitare, disabilitare e analizzare gli stati dei servizi, analizzare le operazioni e utilizzare la quota e la fatturazione per un progetto consumer.^{(Nota 1)}
CA Service Admin ^Beta	roles/privateca.admin	Progetto parco risorse	Accesso completo a tutte le risorse del servizio CA. ^{(Nota 2)}

Note:

Amministratore Service Usage: questo ruolo è necessario come prerequisito per abilitare l'API mesh.googleapis.com quando il provisioning iniziale di Cloud Service Mesh gestito.
Amministratore di servizio CA: questo ruolo è obbligatorio solo se stai eseguendo l'integrazione con il servizio CA.

Installa Cloud Service Mesh

Di seguito viene descritto come installare Cloud Service Mesh:

Esegui asmcli install per installare il piano di controllo in-cluster su un singolo cluster. Consulta le sezioni seguenti per alcuni esempi di riga di comando. Gli esempi contengono sia argomenti obbligatori sia argomenti facoltativi che potresti trovare utili. Ti consigliamo di specificare sempre l'argomento output_dir in modo che che puoi individuare gateway e strumenti di esempio come istioctl. Consulta le barra di navigazione a destra per un elenco di esempi.
(Facoltativo) Installa un gateway di ingresso. Per impostazione predefinita, asmcli non installa istio-ingressgateway. Ti consigliamo di eseguire il deployment e gestire il piano di controllo e i gateway separatamente. Se hai bisogno istio-ingressgateway per impostazione predefinita installato con il piano di controllo nel cluster, includi l'argomento --option legacy-default-ingressgateway.
Per completare la configurazione di Cloud Service Mesh, devi abilitare la funzionalità l'iniezione di file collaterali eseguire il deployment o rieseguire il deployment dei carichi di lavoro.
Se installi Cloud Service Mesh su più di un cluster, esegui asmcli install su ogni cluster. Quando esegui asmcli install, assicurati di utilizzare lo stesso FLEET_PROJECT_ID per ogni cluster. Dopo aver installato Cloud Service Mesh, consulta le istruzioni per configurare un mesh multi-cluster al di fuori di Google Cloud.
Se i cluster si trovano su reti diverse (come accade in modalità isola), devi passare un nome di rete univoco a asmcli utilizzando il flag --network_id.

Installa le funzionalità predefinite e Mesh CA

Questa sezione mostra come eseguire asmcli per installare Cloud Service Mesh con le funzionalità supportate predefinite per la tua piattaforma e abilita Autorità di certificazione Cloud Service Mesh come autorità di certificazione.

On-premise

Esegui i seguenti comandi su Google Distributed Cloud (solo software) per VMware o su Google Distributed Cloud (solo software) per bare metal per installare il control plane con le funzionalità predefinite e l'autorità di certificazione Cloud Service Mesh. Inserisci i valori nel campo segnaposto.

Imposta il contesto corrente sul cluster di utenti:
```
kubectl config use-context CLUSTER_NAME
```
Corsa di asmcli install:
```
./asmcli install \
  --fleet_id FLEET_PROJECT_ID \
  --kubeconfig KUBECONFIG_FILE \
  --output_dir DIR_PATH \
  --platform multicloud \
  --enable_all \
  --ca mesh_ca
```
- --fleet_id L'ID del progetto host del parco risorse.
- --kubeconfig Il percorso completo kubeconfig file. La variabile di ambiente $PWD non funziona qui. Inoltre, le posizioni dei file kubeconfig relative che utilizzano un carattere `~` non funzioneranno.
- --output_dir Includi questa opzione per specificare una directory dove asmcli scarica anthos-service-mesh pacchetto ed estrae il file di installazione, contiene istioctl, esempi e manifest. Altrimenti asmcli scarica i file in una directory tmp. Puoi specificare un percorso relativo o un percorso completo. La variabile di ambiente $PWD non funziona qui.
- --platform multicloud Specifica che la piattaforma è diversa da Google Cloud, ad esempio on-premise o multi-cloud.
- --enable_all Consente allo script di:
  - Concedi le autorizzazioni IAM richieste.
  - Abilita le API Google richieste.
  - Imposta un'etichetta sul cluster che identifichi il mesh.
  - Registra il cluster nel parco risorse, se non è già registrato.
- --ca mesh_ca Utilizza l'autorità di certificazione Cloud Service Mesh come dell'autorità di certificazione. asmcliconfigura Autorità di certificazione Cloud Service Mesh da utilizzare flotta Workload Identity

Per visualizzare gli SLO e le metriche di infrastruttura nell'interfaccia utente di Cloud Service Mesh, devi anche eseguire i primi tre passaggi di Attivare il monitoraggio e il logging delle applicazioni. Se il logging e il monitoraggio non sono abilitati e non ricevi log e la dashboard di Cloud Service Mesh non mostrerà SLO, log degli errori o e le metriche di memoria.

AWS

Esegui i seguenti comandi su GKE su AWS per installare il piano di controllo con le funzionalità predefinite e l'autorità di certificazione Cloud Service Mesh. Inserisci i valori nei segnaposto forniti.

Imposta il contesto attuale sul cluster utente:
```
kubectl config use-context CLUSTER_NAME
```
Esegui asmcli install:
```
./asmcli install \
  --fleet_id FLEET_PROJECT_ID \
  --kubeconfig KUBECONFIG_FILE \
  --output_dir DIR_PATH \
  --platform multicloud \
  --enable_all \
  --ca mesh_ca
```
- --fleet_id L'ID del progetto progetto host del parco risorse.
- --kubeconfig Il percorso completo del file kubeconfig. La variabile di ambiente $PWD non funziona qui. Inoltre, le posizioni dei file kubeconfig relative che utilizzano un carattere `~` non funzioneranno.
- --output_dir Includi questa opzione per specificare una directory dove asmcli scarica anthos-service-mesh pacchetto ed estrae il file di installazione, contiene istioctl, esempi e manifest. Altrimenti asmcli scarica i file in una directory tmp. Puoi specificare un percorso relativo o un percorso completo. La variabile di ambiente $PWD non funziona qui.
- --platform multicloud Specifica che la piattaforma è diversa da Google Cloud, ad esempio on-premise o multi-cloud.
- --enable_all Consente allo script di:
  - Concedi le autorizzazioni IAM richieste.
  - Abilita le API Google richieste.
  - Imposta un'etichetta sul cluster che identifichi il mesh.
  - Registra il cluster nel parco risorse, se non è già registrato.
- --ca mesh_ca Utilizza l'autorità di certificazione Cloud Service Mesh come autorità di certificazione. asmcliconfigura l'autorità di certificazione Cloud Service Mesh per utilizzare l'identità del workload del parco risorse.

Per visualizzare gli SLO e le metriche dell'infrastruttura nella UI di Cloud Service Mesh, devi anche i primi tre passaggi Abilitare il logging e il monitoraggio delle applicazioni. Se la registrazione e il monitoraggio non sono attivati e non ricevi log e metriche personalizzate, la dashboard di Cloud Service Mesh non mostrerà SLO, log di errore o metriche di CPU e memoria.

Azure

Esegui i comandi seguenti su GKE su Azure per installare il piano di controllo con le funzionalità predefinite e l'autorità di certificazione Cloud Service Mesh. Inserisci i valori negli appositi segnaposto.

Imposta il contesto attuale sul cluster utente:
```
kubectl config use-context CLUSTER_NAME
```
Esegui asmcli install:
```
./asmcli install \
  --fleet_id FLEET_PROJECT_ID \
  --kubeconfig KUBECONFIG_FILE \
  --output_dir DIR_PATH \
  --platform multicloud \
  --enable_all \
  --ca mesh_ca
```
- --fleet_id L'ID del progetto host del parco risorse.
- --kubeconfig Il percorso completo del file kubeconfig. La variabile di ambiente $PWD non funziona qui. Inoltre, le posizioni relative dei file kubeconfig che utilizzano "~" non funzioneranno.
- --output_dir Includi questa opzione per specificare una directory dove asmcli scarica anthos-service-mesh pacchetto ed estrae il file di installazione, contiene istioctl, esempi e manifest. Altrimenti asmcli scarica i file in una directory tmp. Puoi specificare un percorso relativo o un percorso completo. La variabile di ambiente $PWD non funziona qui.
- --platform multicloud Specifica che la piattaforma è diversa da Google Cloud, ad esempio on-premise o multi-cloud.
- --enable_all Consente allo script di:
  - Concedi le autorizzazioni IAM richieste.
  - Abilita le API Google richieste.
  - Imposta un'etichetta sul cluster che identifichi il mesh.
  - Registra il cluster nel parco risorse, se non è già registrato.
- --ca mesh_ca Utilizza l'autorità di certificazione Cloud Service Mesh come dell'autorità di certificazione. asmcliconfigura Autorità di certificazione Cloud Service Mesh da utilizzare flotta Workload Identity.

Per visualizzare gli SLO e le metriche di infrastruttura nell'interfaccia utente di Cloud Service Mesh, devi anche eseguire i primi tre passaggi di Attivare il monitoraggio e il logging delle applicazioni. Se la registrazione e il monitoraggio non sono attivati e non ricevi log e metriche personalizzate, la dashboard di Cloud Service Mesh non mostrerà SLO, log di errore o metriche di CPU e memoria.

Amazon EKS

Esegui i seguenti comandi su Amazon EKS per installare il piano di controllo predefinite e l'autorità di certificazione Cloud Service Mesh. Inserisci i valori nel campo segnaposto forniti.

Imposta il contesto attuale sul cluster utente:
```
kubectl config use-context CLUSTER_NAME
```
Esegui asmcli install:
```
./asmcli install \
  --fleet_id FLEET_PROJECT_ID \
  --kubeconfig KUBECONFIG_FILE \
  --output_dir DIR_PATH \
  --platform multicloud \
  --enable_all \
  --option attached-cluster \
  --network_id default \
  --ca mesh_ca
```
- --fleet_id L'ID del progetto progetto host del parco risorse.
- --kubeconfig Il percorso completo kubeconfig file. La variabile di ambiente $PWD non funziona qui. Inoltre, le posizioni relative dei file kubeconfig che utilizzano "~" non funzioneranno.
- --output_dir Includi questa opzione per specificare una directory dove asmcli scarica anthos-service-mesh pacchetto ed estrae il file di installazione, contiene istioctl, esempi e manifest. Altrimenti asmcli scarica i file in una directory tmp. Puoi specificare un percorso relativo o un percorso completo. La variabile di ambiente $PWD non funziona qui.
- --platform multicloud Specifica che la piattaforma è diversa da Google Cloud, ad esempio on-premise o multi-cloud.
- --enable_all Consente allo script di:
  - Concedi le autorizzazioni IAM richieste.
  - Abilita le API Google richieste.
  - Imposta un'etichetta sul cluster che identifichi il mesh.
  - Registra il cluster nel parco risorse, se non è già registrato.
- --option attached-cluster Modifica l'utilità di firma predefinita in istiod.
- --network_id Se stai configurando una mesh multirete, imposta --network_id su un valore univoco per ogni cluster della mesh.
- --ca mesh_ca Utilizza l'autorità di certificazione Cloud Service Mesh come autorità di certificazione. asmcliconfigura l'autorità di certificazione Cloud Service Mesh per utilizzare l'identità del workload del parco risorse.

Microsoft AKS

Esegui i seguenti comandi su Microsoft AKS per installare il piano di controllo con le funzionalità predefinite e l'autorità di certificazione Cloud Service Mesh. Inserisci i valori nel campo segnaposto forniti.

Imposta il contesto attuale sul cluster utente:
```
kubectl config use-context CLUSTER_NAME
```
Corsa di asmcli install:
```
HUB_REGISTRATION_EXTRA_FLAGS=--has-private-issuer ./asmcli install \
  --fleet_id FLEET_PROJECT_ID \
  --kubeconfig KUBECONFIG_FILE \
  --output_dir DIR_PATH \
  --platform multicloud \
  --enable_all \
  --option attached-cluster \
  --network_id default \
  --ca mesh_ca
```
- HUB_REGISTRATION_EXTRA_FLAGS=--has-private-issuer Consente la registrazione con GKE Hub.
- --fleet_id L'ID del progetto host del parco risorse.
- --kubeconfig Il percorso completo kubeconfig file. La variabile di ambiente $PWD non funziona qui. Inoltre, le posizioni relative dei file kubeconfig che utilizzano "~" non funzioneranno.
- --output_dir Includi questa opzione per specificare una directory dove asmcli scarica anthos-service-mesh pacchetto ed estrae il file di installazione, contiene istioctl, esempi e manifest. Altrimenti asmcli scarica i file in una directory tmp. Puoi specificare un percorso relativo o un percorso completo. La variabile di ambiente $PWD non funziona qui.
- --platform multicloud specifica che la piattaforma è qualcosa diverso da Google Cloud, ad esempio on-premise o multi-cloud.
- --enable_all Consente allo script di:
  - Concedi le autorizzazioni IAM richieste.
  - Abilita le API Google richieste.
  - Imposta un'etichetta sul cluster che identifichi il mesh.
  - Registra il cluster nel parco risorse, se non è già registrato.
- --option attached-cluster Modifica l'utilità di firma predefinita in istiod.
- --network_id Se configuri una rete mesh di più reti, imposta --network_id su un valore univoco per ogni cluster nella rete.
- --ca mesh_ca Utilizza l'autorità di certificazione Cloud Service Mesh come autorità di certificazione. asmcliconfigura l'autorità di certificazione Cloud Service Mesh per utilizzare l'identità del workload del parco risorse.

Installa le funzionalità predefinite e il servizio dell'autorità di certificazione (CA)

Questa sezione mostra come eseguire asmcli per installare Cloud Service Mesh con le funzionalità supportate predefinite per la tua piattaforma e attivare il servizio CA come autorità di certificazione.

Nota sulla piattaforma: CA Service è supportato solo sulla le piattaforme seguenti: cluster GKE su Google Cloud, Google Distributed Cloud (solo software) per VMware e Distributed Cloud. Se esegui asmcli install e specifica --ca gcp_cas su altro piattaforme, l'installazione sembra riuscita, ma i carichi di lavoro non riusciranno per iniziare.

Oltre all'autorità di certificazione Cloud Service Mesh, puoi configurare Cloud Service Mesh per utilizzare Certificate Authority Service. Questa guida ti offre l'opportunità di eseguire l'integrazione con CA Service, consigliato per i seguenti casi d'uso:

Se sono necessarie autorità di certificazione diverse per firmare i certificati dei carichi di lavoro su cluster diversi.
Se devi eseguire il backup delle chiavi di firma in un HSM gestito.
Se operi in un settore altamente regolamentato e sei soggetto a conformità.
Se vuoi collegare la CA Cloud Service Mesh a un certificato radice aziendale personalizzato per firmare i certificati del carico di lavoro.

Il costo dell'autorità di certificazione Cloud Service Mesh è incluso nei prezzi di Cloud Service Mesh. La CA Service non è incluso nel prezzo base di Cloud Service Mesh ed è con un addebito separato. Inoltre, il servizio CA è dotato di un SLA esplicito, ma l'autorità di certificazione Cloud Service Mesh no.

Configura CA Service

Crea il pool di CA nel livello DevOps e nella stessa regione cluster che gestisce per evitare problemi di latenza eccessivi o potenziali tra regioni diverse. Per saperne di più, vedi Livelli ottimizzati per il carico di lavoro.
Crea la CA avere almeno un'autorità di certificazione attiva nel pool di CA in stesso progetto del cluster GKE. Utilizza CA subordinate per firmare Certificati per i carichi di lavoro di Cloud Service Mesh. Prendi nota del pool di CA corrispondente alla CA subordinata.

Se intendi utilizzare solo certificati di servizio per i carichi di lavoro di Cloud Service Mesh, imposta i seguenti criteri di emissione per il pool di CA:

policy.yaml

baselineValues:
  keyUsage:
    baseKeyUsage:
      digitalSignature: true
      keyEncipherment: true
    extendedKeyUsage:
      serverAuth: true
      clientAuth: true
  caOptions:
    isCa: false
identityConstraints:
  allowSubjectPassthrough: false
  allowSubjectAltNamesPassthrough: true
  celExpression:
    expression: subject_alt_names.all(san, san.type == URI && san.value.startsWith("spiffe://PROJECT_ID.svc.id.goog/ns/") )

Per aggiornare il criterio di emissione del pool di CA, utilizza il seguente comando:
```
gcloud privateca pools update CA_POOL --location ca_region --issuance-policy policy.yaml
```
Per informazioni sull'impostazione di un criterio su un pool, consulta Utilizzo di un criterio di emissione dei certificati.
Se utilizzi un modello di certificato, configuralo ora. Per ulteriori informazioni, Segui la guida di CA Service per i certificati di identità per i carichi di lavoro. Assicurati che il modello di certificato sia creato nella stessa regione del pool di CA. Se sono presenti più regioni per i pool di CA, crea un certificato modello per regione.

Configura Cloud Service Mesh per utilizzare il servizio CA

Esegui i comandi seguenti su Google Distributed Cloud (solo software) per VMware Google Distributed Cloud (solo software) per bare metal per installare il piano di controllo con funzionalità predefinite e Certificate Authority Service. Inserisci i valori negli appositi segnaposto.

Imposta il contesto attuale sul cluster utente:
```
kubectl config use-context CLUSTER_NAME
```
Corsa di asmcli install:
```
./asmcli install \
  --kubeconfig KUBECONFIG_FILE \
  --fleet_id FLEET_PROJECT_ID \
  --output_dir DIR_PATH \
  --enable_all \
  --ca gcp_cas \
  --platform multicloud \
  --ca_pool  projects/CA_POOL_PROJECT_ID/locations/ca_region/caPools/CA_POOL
```
- --fleet_id L'ID del progetto progetto host del parco risorse.
- --kubeconfig Il percorso completo del file kubeconfig. La variabile di ambiente $PWD non funziona qui. Inoltre, le posizioni dei file kubeconfig relative che utilizzano un carattere `~` non funzioneranno.
- --output_dir Includi questa opzione per specificare una directory dove asmcli scarica anthos-service-mesh pacchetto ed estrae il file di installazione, contiene istioctl, esempi e manifest. Altrimenti asmcli scarica i file in una directory tmp. Puoi specificare un percorso relativo o un percorso completo. La variabile di ambiente $PWD non funziona qui.
- --platform multicloud Specifica che la piattaforma è diversa da Google Cloud, ad esempio on-premise o multi-cloud.
- --enable_all Consente allo script di:
  - Concedi le autorizzazioni IAM richieste.
  - Abilita le API Google richieste.
  - Imposta un'etichetta sul cluster che identifichi il mesh.
  - Registra il cluster nel parco risorse, se non è già registrato.
- --ca gcp_cas Utilizza Certificate Authority Service come dell'autorità di certificazione. La modifica delle autorità di certificazione durante un l'upgrade causa tempi di inattività. asmcliconfigura Certificate Authority Service da utilizzare flotta Workload Identity
- --ca_pool L'identificatore completo del Pool di CA di Certificate Authority Service. Se utilizzi un modello di certificato, aggiungi l'ID modello separato da :. Ad esempio:
```
  --ca_pool projects/CA_POOL_PROJECT_ID/locations/ca_region/caPools/CA_POOL:projects/CA_POOL_PROJECT_ID/locations/ca_region/certificateTemplates/CERT_TEMPLATE_ID
  
```
Per visualizzare gli SLO e le metriche di infrastruttura nell'interfaccia utente di Cloud Service Mesh, devi anche eseguire i primi tre passaggi di Attivare il monitoraggio e il logging delle applicazioni. Se il logging e il monitoraggio non sono abilitati e non ricevi log e la dashboard di Cloud Service Mesh non mostrerà SLO, log degli errori o e le metriche di memoria.

Installa le funzionalità predefinite con Istio CA

Questa sezione spiega come:

Genera certificati e chiavi per la CA Istio che Cloud Service Mesh utilizza per firma i tuoi carichi di lavoro.
Esegui asmcli per installare Cloud Service Mesh con le funzionalità predefinite e abilitarlo CA Istio.

Per impostazione predefinita, gli ambienti che installano Cloud Service Mesh con Istio CA registrano le metriche in Prometheus. Se vuoi utilizzare le dashboard di Cloud Service Mesh, devi abilitare di Stackdriver. Per maggiori informazioni, vedi Installazione con funzionalità facoltative.

Per la migliore sicurezza, consigliamo vivamente di mantenere una CA radice offline utilizzando le CA subordinate per emettere certificati per ciascun cluster. Per ulteriori informazioni, consulta Collegare i certificati CA. In questa configurazione, tutti i carichi di lavoro nel servizio mesh utilizzano la stessa autorità di certificazione (CA) principale. Ogni CA Cloud Service Mesh utilizza una CA intermedia chiave di firma e certificato, firmati dalla CA radice. Quando esistono più CA all'interno di un mesh, viene stabilita una gerarchia di attendibilità tra le CA. Puoi ripetere questi passaggi per eseguire il provisioning di certificati e chiavi per un numero qualsiasi di autorità di certificazione.

Il Makefile per generare i certificati si trova nella Sottodirectory istio-1.21.5-asm.12 nella directory --output_dir che specificato nel comando asmcli validate. Se non hai eseguito asmcli validate, o se la directory scaricata non è disponibile localmente, puoi recuperare il Makefile il download del file di installazione di Cloud Service Mesh ed estrarre i contenuti.

Passa alla directory istio-1.21.5-asm.12.
Crea una directory per i certificati e le chiavi:
```
mkdir -p certs && \
pushd certs
```
Genera un certificato e una chiave radice:
```
make -f ../tools/certs/Makefile.selfsigned.mk root-ca
```
Vengono generati i seguenti file:
- root-cert.pem: il certificato radice
- root-key.pem: la chiave principale
- root-ca.conf: la configurazione per openssl per generare il certificato radice
- root-cert.csr: la richiesta di firma del certificato per il certificato radice.
Genera un certificato e una chiave intermedi:
```
make -f ../tools/certs/Makefile.selfsigned.mk cluster1-cacerts
```
Questa operazione genera i seguenti file in una directory denominata cluster1:
- ca-cert.pem: i certificati intermedi
- ca-key.pem: la chiave intermedia
- cert-chain.pem: la catena di certificati utilizzata da istiod
- root-cert.pem: il certificato radice
Nota: puoi sostituire cluster1 con un altro nome. Ad esempio, make mycluster-cacerts crea una directory denominata mycluster.

Se esegui questi passaggi utilizzando un computer offline, copia la directory generata su un computer con accesso ai cluster.
Torna alla directory precedente:
```
popd
```
Esegui asmcli per installare un mesh utilizzando la CA Istio:
On-premise
Esegui i seguenti comandi su Google Distributed Cloud (solo software) per VMware o su Google Distributed Cloud (solo software) per bare metal per installare il piano di controllo con le funzionalità predefinite e la CA Istio. Inserisci i valori nei segnaposto forniti.
1. Imposta il contesto corrente sul cluster di utenti:
  kubectl config use-context CLUSTER_NAME
2. Corsa di asmcli install:
  ./asmcli install \ --fleet_id FLEET_PROJECT_ID \ --kubeconfig KUBECONFIG_FILE \ --output_dir DIR_PATH \ --platform multicloud \ --enable_all \ --ca citadel \ --ca_cert CA_CERT_FILE_PATH \ --ca_key CA_KEY_FILE_PATH \ --root_cert ROOT_CERT_FILE_PATH \ --cert_chain CERT_CHAIN_FILE_PATH
  - --fleet_id L'ID del progetto host del parco risorse.
  - --kubeconfig Il percorso completo del file kubeconfig. La variabile di ambiente $PWD non funziona qui. Inoltre, le posizioni relative dei file kubeconfig che utilizzano "~" non funzioneranno.
  - --output_dir Includi questa opzione per specificare una directory dove asmcli scarica anthos-service-mesh pacchetto ed estrae il file di installazione, contiene istioctl, esempi e manifest. Altrimenti asmcli scarica i file in una directory tmp. Puoi specificare un percorso relativo o un percorso completo. La variabile di ambiente $PWD non funziona qui.
  - --platform multicloud specifica che la piattaforma è qualcosa diverso da Google Cloud, ad esempio on-premise o multi-cloud.
  - --enable_all Consente allo script di:
    
    Concedi le autorizzazioni IAM richieste.
    
    Abilita le API Google richieste.
    
    Imposta un'etichetta sul cluster che identifichi il mesh.
    
    Registra il cluster nel parco risorse, se non è già registrato.
  - -ca citadel Utilizza la CA Istio come autorità di certificazione.
  - --ca_cert Il certificato intermedio
  - --ca_key La chiave per il certificato intermedio
  - --root_cert Il certificato radice
  - --cert_chain La catena di certificati
AWS
Esegui i seguenti comandi su GKE su AWS per installare il piano di controllo con le funzionalità predefinite e la CA Istio. Inserisci i valori nel campo segnaposto forniti. Puoi scegliere di attivare Ingress per la subnet pubblica o per la subnet privata.
Pubblico

Imposta il contesto corrente sul cluster di utenti:

kubectl config use-context CLUSTER_NAME

Esegui asmcli install:

./asmcli install \ --fleet_id FLEET_PROJECT_ID \ --kubeconfig KUBECONFIG_FILE \ --output_dir DIR_PATH \ --platform multicloud \ --enable_all \ --ca citadel \ --ca_cert CA_CERT_FILE_PATH \ --ca_key CA_KEY_FILE_PATH \ --root_cert ROOT_CERT_FILE_PATH \ --cert_chain CERT_CHAIN_FILE_PATH

--fleet_id L'ID del progetto host del parco risorse.

--kubeconfig Il percorso completo kubeconfig file. La variabile di ambiente $PWD non funziona qui. Inoltre, le posizioni dei file kubeconfig relative che utilizzano un carattere `~` non funzioneranno.
--output_dir Includi questa opzione per specificare una directory dove asmcli scarica anthos-service-mesh pacchetto ed estrae il file di installazione, contiene istioctl, esempi e manifest. Altrimenti asmcli scarica i file in una directory tmp. Puoi specificare un percorso relativo o un percorso completo. La variabile di ambiente $PWD non funziona qui.

--platform multicloud Specifica che la piattaforma è diversa da Google Cloud, ad esempio on-premise o multi-cloud.
--enable_all Consente allo script di:

Concedi le autorizzazioni IAM richieste.

Abilita le API Google richieste.

Imposta un'etichetta sul cluster che identifichi il mesh.

Registra il cluster nel parco risorse, se non è già registrato.

-ca citadel Utilizza Istio CA come autorità di certificazione.

--ca_cert Il certificato intermedio.

--ca_key La chiave del certificato intermedio.

--root_cert Il certificato radice.

--cert_chain La catena di certificati.
Privato

Imposta il contesto corrente sul cluster di utenti:

kubectl config use-context CLUSTER_NAME

Salva il seguente codice YAML in un file denominato istio-operator-internal-lb.yaml:

apiVersion: install.istio.io/v1alpha1 kind: IstioOperator spec: components: ingressGateways: - enabled: true k8s: serviceAnnotations: service.beta.kubernetes.io/aws-load-balancer-internal: "true" name: istio-ingressgateway

Esegui asmcli install:

./asmcli install \ --fleet_id FLEET_PROJECT_ID \ --kubeconfig KUBECONFIG_FILE \ --output_dir DIR_PATH \ --platform multicloud \ --enable_all \ --ca citadel \ --ca_cert FILE_PATH \ --ca_key FILE_PATH \ --root_cert FILE_PATH \ --cert_chain FILE_PATH \ --custom_overlay istio-operator-internal-lb.yaml

--fleet_id L'ID del progetto host del parco risorse.

--kubeconfig Il percorso completo del file kubeconfig. La variabile di ambiente $PWD non funziona qui. Inoltre, le posizioni dei file kubeconfig relative che utilizzano un carattere `~` non funzioneranno.
--output_dir Includi questa opzione per specificare una directory dove asmcli scarica anthos-service-mesh pacchetto ed estrae il file di installazione, contiene istioctl, esempi e manifest. Altrimenti asmcli scarica i file in una directory tmp. Puoi specificare un percorso relativo o un percorso completo. La variabile di ambiente $PWD non funziona qui.

--platform multicloud Specifica che la piattaforma è diversa da Google Cloud, ad esempio on-premise o multi-cloud.
--enable_all Consente allo script di:

Concedi le autorizzazioni IAM richieste.

Abilita le API Google richieste.

Imposta un'etichetta sul cluster che identifichi il mesh.

Registra il cluster nel parco risorse, se non è già registrato.

-ca citadel Utilizza la CA Istio come autorità di certificazione.

--ca_cert Il certificato intermedio.

--ca_key La chiave del certificato intermedio.

--root_cert Il certificato radice.

--cert_chain La catena di certificati.

--custom_overlay Il nome del file dell'overlay creato. Per ulteriori informazioni sui file overlay, consulta Attivare funzionalità facoltative nel piano di controllo in-cluster.
Azure
Esegui i comandi seguenti su GKE su Azure per installare il piano di controllo con le funzionalità predefinite e la CA Istio. Inserisci il tuo nei segnaposto forniti. Puoi scegliere di abilitare Ingress per nella subnet pubblica o nella subnet privata.
Pubblico

Imposta il contesto corrente sul cluster di utenti:

kubectl config use-context CLUSTER_NAME

Corsa di asmcli install:

./asmcli install \ --fleet_id FLEET_PROJECT_ID \ --kubeconfig KUBECONFIG_FILE \ --output_dir DIR_PATH \ --platform multicloud \ --enable_all \ --ca citadel \ --ca_cert CA_CERT_FILE_PATH \ --ca_key CA_KEY_FILE_PATH \ --root_cert ROOT_CERT_FILE_PATH \ --cert_chain CERT_CHAIN_FILE_PATH

--fleet_id L'ID del progetto progetto host del parco risorse.

--kubeconfig Il percorso completo kubeconfig file. La variabile di ambiente $PWD non funziona qui. Inoltre, le posizioni relative dei file kubeconfig che utilizzano "~" non funzioneranno.
--output_dir Includi questa opzione per specificare una directory dove asmcli scarica anthos-service-mesh pacchetto ed estrae il file di installazione, contiene istioctl, esempi e manifest. Altrimenti asmcli scarica i file in una directory tmp. Puoi specificare un percorso relativo o un percorso completo. La variabile di ambiente $PWD non funziona qui.

--platform multicloud Specifica che la piattaforma è diversa da Google Cloud, ad esempio on-premise o multi-cloud.
--enable_all Consente allo script di:

Concedi le autorizzazioni IAM richieste.

Abilita le API Google richieste.

Imposta un'etichetta sul cluster che identifichi il mesh.

Registra il cluster nel parco risorse, se non è già registrato.

-ca citadel Utilizza la CA Istio come autorità di certificazione.

--ca_cert Il certificato intermedio.

--ca_key La chiave del certificato intermedio.

--root_cert Il certificato radice.

--cert_chain La catena di certificati.
Privato

Imposta il contesto corrente sul cluster di utenti:

kubectl config use-context CLUSTER_NAME

Salva il seguente codice YAML in un file denominato istio-operator-internal-lb.yaml:

apiVersion: install.istio.io/v1alpha1 kind: IstioOperator spec: components: ingressGateways: - enabled: true k8s: serviceAnnotations: service.beta.kubernetes.io/aws-load-balancer-internal: "true" name: istio-ingressgateway

Esegui asmcli install:

./asmcli install \ --fleet_id FLEET_PROJECT_ID \ --kubeconfig KUBECONFIG_FILE \ --output_dir DIR_PATH \ --platform multicloud \ --enable_all \ --ca citadel \ --ca_cert FILE_PATH \ --ca_key FILE_PATH \ --root_cert FILE_PATH \ --cert_chain FILE_PATH \ --custom_overlay istio-operator-internal-lb.yaml

--fleet_id L'ID del progetto progetto host del parco risorse.

--kubeconfig Il percorso completo kubeconfig file. La variabile di ambiente $PWD non funziona qui. Inoltre, le posizioni dei file kubeconfig relative che utilizzano un carattere `~` non funzioneranno.
--output_dir Includi questa opzione per specificare una directory dove asmcli scarica anthos-service-mesh pacchetto ed estrae il file di installazione, contiene istioctl, esempi e manifest. Altrimenti asmcli scarica i file in una directory tmp. Puoi specificare un percorso relativo o un percorso completo. La variabile di ambiente $PWD non funziona qui.

--platform multicloud Specifica che la piattaforma è diversa da Google Cloud, ad esempio on-premise o multi-cloud.
--enable_all Consente allo script di:

Concedi le autorizzazioni IAM richieste.

Abilita le API Google richieste.

Imposta un'etichetta sul cluster che identifichi il mesh.

Registra il cluster nel parco risorse, se non è già registrato.

-ca citadel Utilizza la CA Istio come autorità di certificazione.

--ca_cert Il certificato intermedio.

--ca_key La chiave del certificato intermedio.

--root_cert Il certificato radice.

--cert_chain La catena di certificati.

--custom_overlay Il nome del file dell'overlay creato. Per ulteriori informazioni sui file overlay, consulta Attivare funzionalità facoltative nel piano di controllo in-cluster.
Amazon EKS
Esegui i seguenti comandi su Amazon EKS per installare il piano di controllo le funzionalità predefinite e Istio CA. Inserisci i valori nel campo segnaposto.
1. Imposta il contesto corrente sul cluster di utenti:
  kubectl config use-context CLUSTER_NAME
2. Corsa di asmcli install:
  ./asmcli install \ --fleet_id FLEET_PROJECT_ID \ --kubeconfig KUBECONFIG_FILE \ --output_dir DIR_PATH \ --platform multicloud \ --enable_all \ --option attached-cluster \ --ca citadel \ --ca_cert CA_CERT_FILE_PATH \ --ca_key CA_KEY_FILE_PATH \ --root_cert ROOT_CERT_FILE_PATH \ --cert_chain CERT_CHAIN_FILE_PATH \ --network_id default
  - --fleet_id L'ID del progetto progetto host del parco risorse.
  - --kubeconfig Il percorso completo del file kubeconfig. La variabile di ambiente $PWD non funziona qui. Inoltre, le posizioni relative dei file kubeconfig che utilizzano "~" non funzioneranno.
  - --output_dir Includi questa opzione per specificare una directory dove asmcli scarica anthos-service-mesh pacchetto ed estrae il file di installazione, contiene istioctl, esempi e manifest. Altrimenti asmcli scarica i file in una directory tmp. Puoi specificare un percorso relativo o un percorso completo. La variabile di ambiente $PWD non funziona qui.
  - --platform multicloud Specifica che la piattaforma è diversa da Google Cloud, ad esempio on-premise o multi-cloud.
  - --enable_all Consente allo script di:
    
    Concedi le autorizzazioni IAM richieste.
    
    Abilita le API Google richieste.
    
    Imposta un'etichetta sul cluster che identifichi il mesh.
    
    Registra il cluster nel parco risorse, se non è già registrato.
  - --option attached-cluster cambia la firma predefinita e l'utilità è istiod.
  - -ca citadel Utilizza la CA Istio come autorità di certificazione.
  - --ca_cert Il certificato intermedio
  - --ca_key La chiave per il certificato intermedio
  - --root_cert Il certificato radice
  - --cert_chain La catena di certificati
  - --network_id Se stai configurando una rete mesh con più reti, imposta --network_id su un valore univoco per ogni cluster della rete mesh.
Microsoft AKS
Esegui questi comandi su Microsoft AKS per installare il piano di controllo con le funzionalità predefinite e Istio CA. Inserisci i valori nei segnaposto forniti.
1. Imposta il contesto corrente sul cluster di utenti:
  kubectl config use-context CLUSTER_NAME
2. Corsa di asmcli install:
  HUB_REGISTRATION_EXTRA_FLAGS=--has-private-issuer ./asmcli install \ --fleet_id FLEET_PROJECT_ID \ --kubeconfig KUBECONFIG_FILE \ --output_dir DIR_PATH \ --platform multicloud \ --enable_all \ --option attached-cluster \ --ca citadel \ --ca_cert CA_CERT_FILE_PATH \ --ca_key CA_KEY_FILE_PATH \ --root_cert ROOT_CERT_FILE_PATH \ --cert_chain CERT_CHAIN_FILE_PATH \ --network_id default
  - HUB_REGISTRATION_EXTRA_FLAGS=--has-private-issuer Consente la registrazione con GKE Hub.
  - --fleet_id L'ID del progetto host del parco risorse.
  - --kubeconfig Il percorso completo kubeconfig file. La variabile di ambiente $PWD non funziona qui. Inoltre, le posizioni relative dei file kubeconfig che utilizzano "~" non funzioneranno.
  - --output_dir Includi questa opzione per specificare una directory dove asmcli scarica anthos-service-mesh pacchetto ed estrae il file di installazione, contiene istioctl, esempi e manifest. Altrimenti asmcli scarica i file in una directory tmp. Puoi specificare un percorso relativo o un percorso completo. La variabile di ambiente $PWD non funziona qui.
  - --platform multicloud Specifica che la piattaforma è diversa da Google Cloud, ad esempio on-premise o multi-cloud.
  - --enable_all Consente allo script di:
    
    Concedi le autorizzazioni IAM richieste.
    
    Abilita le API Google richieste.
    
    Imposta un'etichetta sul cluster che identifichi il mesh.
    
    Registra il cluster nel parco risorse, se non è già registrato.
  - --option attached-cluster cambia la firma predefinita e l'utilità è istiod.
  - -ca citadel Utilizza Istio CA come autorità di certificazione.
  - --ca_cert Il certificato intermedio
  - --ca_key La chiave per il certificato intermedio
  - --root_cert Il certificato radice
  - --cert_chain La catena di certificati
  - --network_id Se stai configurando una rete mesh con più reti, imposta --network_id su un valore univoco per ogni cluster della rete mesh.

Installa con Istio CA con Google Cloud Observability abilitato

Se vuoi utilizzare le dashboard di Cloud Service Mesh, devi abilitare Stackdriver.

On-premise

Esegui i seguenti comandi su Google Distributed Cloud (solo software) per VMware o Google Distributed Cloud (solo software) per bare metal per installare il piano di controllo con Stackdriver e altre funzionalità facoltative e la CA Istio. Inserisci i valori nei segnaposto forniti.

Imposta il contesto attuale sul cluster utente:
```
kubectl config use-context CLUSTER_NAME
```
Corsa di asmcli install:
```
./asmcli install \
   --fleet_id FLEET_PROJECT_ID \
   --kubeconfig KUBECONFIG_FILE \
   --output_dir DIR_PATH \
   --platform multicloud \
   --enable_all \
   --ca citadel \
   --ca_cert CA_CERT_FILE_PATH \
   --ca_key CA_KEY_FILE_PATH \
   --root_cert ROOT_CERT_FILE_PATH \
   --cert_chain CERT_CHAIN_FILE_PATH
```
- --fleet_id L'ID del progetto progetto host del parco risorse.
- --kubeconfig Il percorso completo kubeconfig file. La variabile di ambiente $PWD non funziona qui. Inoltre, le posizioni dei file kubeconfig relative che utilizzano un carattere `~` non funzioneranno.
- --output_dir Includi questa opzione per specificare una directory dove asmcli scarica anthos-service-mesh pacchetto ed estrae il file di installazione, contiene istioctl, esempi e manifest. Altrimenti asmcli scarica i file in una directory tmp. Puoi specificare un percorso relativo o un percorso completo. La variabile di ambiente $PWD non funziona qui.
- --platform multicloud specifica che la piattaforma è qualcosa diverso da Google Cloud, ad esempio on-premise o multi-cloud.
- --enable_all Consente allo script di:
  - Concedi le autorizzazioni IAM richieste.
  - Abilita le API Google richieste.
  - Imposta un'etichetta sul cluster che identifichi il mesh.
  - Registra il cluster nel parco risorse, se non è già registrato.
- -ca citadel Utilizza la CA Istio come autorità di certificazione.
- --ca_cert Il certificato intermedio
- --ca_key La chiave per il certificato intermedio
- --root_cert Il certificato radice
- --cert_chain La catena di certificati
- --option stackdriver Attiva l'opzione Stackdriver. Tieni presente che puoi anche abilitare sia Stackdriver che Prometheus utilizzando --option prometheus-and-stackdriver.
Per visualizzare gli SLO e le metriche dell'infrastruttura nella UI di Cloud Service Mesh, devi anche i primi tre passaggi Abilitare il logging e il monitoraggio delle applicazioni. Se la registrazione e il monitoraggio non sono attivati e non ricevi log e metriche personalizzate, la dashboard di Cloud Service Mesh non mostrerà SLO, log di errore o metriche di CPU e memoria.

AWS

Esegui i comandi seguenti su GKE su AWS per installare il controllo con Stackdriver, altre funzionalità facoltative e la CA di Istio. Inserisci il tuo nei segnaposto forniti. Puoi scegliere di attivare Ingress per la subnet pubblica o per la subnet privata.

Pubblico

Imposta il contesto corrente sul cluster di utenti:
```
kubectl config use-context CLUSTER_NAME
```
Corsa di asmcli install:
```
./asmcli install \
  --fleet_id FLEET_PROJECT_ID \
  --kubeconfig KUBECONFIG_FILE \
  --output_dir DIR_PATH \
  --platform multicloud \
  --enable_all \
  --ca citadel \
  --ca_cert CA_CERT_FILE_PATH \
  --ca_key CA_KEY_FILE_PATH \
  --root_cert ROOT_CERT_FILE_PATH \
  --cert_chain CERT_CHAIN_FILE_PATH \
  --option stackdriver
```
- --fleet_id L'ID del progetto progetto host del parco risorse.
- --kubeconfig Il percorso completo del file kubeconfig. La variabile di ambiente $PWD non funziona qui. Inoltre, le posizioni relative dei file kubeconfig che utilizzano "~" non funzioneranno.
- --output_dir Includi questa opzione per specificare una directory dove asmcli scarica anthos-service-mesh pacchetto ed estrae il file di installazione, contiene istioctl, esempi e manifest. Altrimenti asmcli scarica i file in una directory tmp. Puoi specificare un percorso relativo o un percorso completo. La variabile di ambiente $PWD non funziona qui.
- --platform multicloud Specifica che la piattaforma è diversa da Google Cloud, ad esempio on-premise o multi-cloud.
- --enable_all Consente allo script di:
  - Concedi le autorizzazioni IAM richieste.
  - Abilita le API Google richieste.
  - Imposta un'etichetta sul cluster che identifichi il mesh.
  - Registra il cluster nel parco risorse, se non è già registrato.
- -ca citadel Utilizza Istio CA come autorità di certificazione.
- --ca_cert Il certificato intermedio.
- --ca_key La chiave del certificato intermedio.
- --root_cert Il certificato radice.
- --cert_chain La catena di certificati.
- --option stackdriver Abilita l'opzione Stackdriver. Tieni presente che puoi anche abilitare sia Stackdriver che Prometheus utilizzando --option prometheus-and-stackdriver.

Privato

Imposta il contesto corrente sul cluster di utenti:
```
kubectl config use-context CLUSTER_NAME
```

Salva il seguente codice YAML in un file denominato istio-operator-internal-lb.yaml:

apiVersion: install.istio.io/v1alpha1
kind: IstioOperator
spec:
  components:
    ingressGateways:
    - enabled: true
      k8s:
        serviceAnnotations:
          service.beta.kubernetes.io/aws-load-balancer-internal: "true"
      name: istio-ingressgateway

Esegui asmcli install:
```
./asmcli install \
  --fleet_id FLEET_PROJECT_ID \
  --kubeconfig KUBECONFIG_FILE \
  --output_dir DIR_PATH \
  --platform multicloud \
  --enable_all \
  --ca citadel \
  --ca_cert FILE_PATH \
  --ca_key FILE_PATH \
  --root_cert FILE_PATH \
  --cert_chain FILE_PATH
  --custom_overlay istio-operator-internal-lb.yaml \
  --option stackdriver
```
- --fleet_id L'ID del progetto host del parco risorse.
- --kubeconfig Il percorso completo del file kubeconfig. La variabile di ambiente $PWD non funziona qui. Inoltre, le posizioni relative dei file kubeconfig che utilizzano "~" non funzioneranno.
- --output_dir Includi questa opzione per specificare una directory dove asmcli scarica anthos-service-mesh pacchetto ed estrae il file di installazione, contiene istioctl, esempi e manifest. Altrimenti asmcli scarica i file in una directory tmp. Puoi specificare un percorso relativo o un percorso completo. La variabile di ambiente $PWD non funziona qui.
- --platform multicloud Specifica che la piattaforma è diversa da Google Cloud, ad esempio on-premise o multi-cloud.
- --enable_all Consente allo script di:
  - Concedi le autorizzazioni IAM richieste.
  - Abilita le API Google richieste.
  - Imposta un'etichetta sul cluster che identifichi il mesh.
  - Registra il cluster nel parco risorse, se non è già registrato.
- -ca citadel Utilizza Istio CA come autorità di certificazione.
- --ca_cert Il certificato intermedio.
- --ca_key La chiave del certificato intermedio.
- --root_cert Il certificato radice.
- --cert_chain La catena di certificati.
- --custom_overlay Il nome del file overlay creato. Per ulteriori informazioni sui file overlay, consulta Attivare funzionalità facoltative nel piano di controllo in-cluster.
- --option stackdriver Abilita l'opzione Stackdriver. Tieni presente che puoi anche abilitare sia Stackdriver che Prometheus utilizzando --option prometheus-and-stackdriver. In alternativa, puoi attivare Stackdriver utilizzando --custom_overlay stackdriver.yaml. Devi: Scarica il pacchetto anthos-service-mesh-package o crea stackdriver.yaml dal manifest fornito.

Azure

Esegui i comandi seguenti su GKE su Azure per installare il piano di controllo con Stackdriver e altre funzionalità facoltative e CA Istio. Inserisci i valori negli appositi segnaposto. Puoi scegliere di attivare Ingress per la subnet pubblica o la subnet privata.

Pubblico

Imposta il contesto corrente sul cluster di utenti:
```
kubectl config use-context CLUSTER_NAME
```
Corsa di asmcli install:
```
./asmcli install \
  --fleet_id FLEET_PROJECT_ID \
  --kubeconfig KUBECONFIG_FILE \
  --output_dir DIR_PATH \
  --platform multicloud \
  --enable_all \
  --ca citadel \
  --ca_cert CA_CERT_FILE_PATH \
  --ca_key CA_KEY_FILE_PATH \
  --root_cert ROOT_CERT_FILE_PATH \
  --cert_chain CERT_CHAIN_FILE_PATH \
  --option stackdriver
```
- --fleet_id L'ID del progetto host del parco risorse.
- --kubeconfig Il percorso completo kubeconfig file. La variabile di ambiente $PWD non funziona qui. Inoltre, le posizioni dei file kubeconfig relative che utilizzano un carattere `~` non funzioneranno.
- --output_dir Includi questa opzione per specificare una directory dove asmcli scarica anthos-service-mesh pacchetto ed estrae il file di installazione, contiene istioctl, esempi e manifest. Altrimenti asmcli scarica i file in una directory tmp. Puoi specificare un percorso relativo o un percorso completo. La variabile di ambiente $PWD non funziona qui.
- --platform multicloud specifica che la piattaforma è qualcosa diverso da Google Cloud, ad esempio on-premise o multi-cloud.
- --enable_all Consente allo script di:
  - Concedi le autorizzazioni IAM richieste.
  - Abilita le API Google richieste.
  - Imposta un'etichetta sul cluster che identifichi il mesh.
  - Registra il cluster nel parco risorse, se non è già registrato.
- -ca citadel Utilizza Istio CA come autorità di certificazione.
- --ca_cert Il certificato intermedio.
- --ca_key La chiave del certificato intermedio.
- --root_cert Il certificato radice.
- --cert_chain La catena di certificati.
- --option stackdriver Abilita l'opzione Stackdriver. Tieni presente che puoi anche abilitare sia Stackdriver che Prometheus utilizzando --option prometheus-and-stackdriver.

Privato

Imposta il contesto corrente sul cluster di utenti:
```
kubectl config use-context CLUSTER_NAME
```

Salva il seguente codice YAML in un file denominato istio-operator-internal-lb.yaml:

apiVersion: install.istio.io/v1alpha1
kind: IstioOperator
spec:
  components:
    ingressGateways:
    - enabled: true
      k8s:
        serviceAnnotations:
          service.beta.kubernetes.io/aws-load-balancer-internal: "true"
      name: istio-ingressgateway

Corsa di asmcli install:
```
./asmcli install \
  --fleet_id FLEET_PROJECT_ID \
  --kubeconfig KUBECONFIG_FILE \
  --output_dir DIR_PATH \
  --platform multicloud \
  --enable_all \
  --ca citadel \
  --ca_cert FILE_PATH \
  --ca_key FILE_PATH \
  --root_cert FILE_PATH \
  --cert_chain FILE_PATH
  --custom_overlay istio-operator-internal-lb.yaml \
  --option stackdriver
```
- --fleet_id L'ID del progetto host del parco risorse.
- --kubeconfig Il percorso completo del file kubeconfig. La variabile di ambiente $PWD non funziona qui. Inoltre, le posizioni dei file kubeconfig relative che utilizzano un carattere `~` non funzioneranno.
- --output_dir Includi questa opzione per specificare una directory dove asmcli scarica anthos-service-mesh pacchetto ed estrae il file di installazione, contiene istioctl, esempi e manifest. Altrimenti asmcli scarica i file in una directory tmp. Puoi specificare un percorso relativo o un percorso completo. La variabile di ambiente $PWD non funziona qui.
- --platform multicloud specifica che la piattaforma è qualcosa diverso da Google Cloud, ad esempio on-premise o multi-cloud.
- --enable_all Consente allo script di:
  - Concedi le autorizzazioni IAM richieste.
  - Abilita le API Google richieste.
  - Imposta un'etichetta sul cluster che identifichi il mesh.
  - Registra il cluster nel parco risorse, se non è già registrato.
- -ca citadel Utilizza Istio CA come autorità di certificazione.
- --ca_cert Il certificato intermedio.
- --ca_key La chiave del certificato intermedio.
- --root_cert Il certificato radice.
- --cert_chain La catena di certificati.
- --custom_overlay Il nome del file overlay creato. Per ulteriori informazioni informazioni sui file di overlay, consulta Attivazione della funzionalità facoltativa sul piano di controllo nel cluster
- --option stackdriver Attiva l'opzione Stackdriver. Tieni presente che puoi anche abilitare sia Stackdriver che Prometheus utilizzando --option prometheus-and-stackdriver. In alternativa, puoi abilitare Stackdriver mediante --custom_overlay stackdriver.yaml. Devi scaricare il pacchetto anthos-service-mesh o creare stackdriver.yaml dal manifest fornito.

Amazon EKS

Esegui i seguenti comandi su Amazon EKS per installare il piano di controllo Stackdriver e altre funzionalità facoltative e CA Istio. Inserisci i valori nei segnaposto forniti.

Imposta il contesto attuale sul cluster utente:
```
kubectl config use-context CLUSTER_NAME
```
Corsa di asmcli install:
```
./asmcli install \
  --fleet_id FLEET_PROJECT_ID \
  --kubeconfig KUBECONFIG_FILE \
  --output_dir DIR_PATH \
  --platform multicloud \
  --enable_all \
  --ca citadel \
  --ca_cert CA_CERT_FILE_PATH \
  --ca_key CA_KEY_FILE_PATH \
  --root_cert ROOT_CERT_FILE_PATH \
  --cert_chain CERT_CHAIN_FILE_PATH \
  --option stackdriver \
  --option attached-cluster
```
- --fleet_id L'ID del progetto progetto host del parco risorse.
- --kubeconfig Il percorso completo kubeconfig file. La variabile di ambiente $PWD non funziona qui. Inoltre, le posizioni relative dei file kubeconfig che utilizzano "~" non funzioneranno.
- --output_dir Includi questa opzione per specificare una directory dove asmcli scarica anthos-service-mesh pacchetto ed estrae il file di installazione, contiene istioctl, esempi e manifest. Altrimenti asmcli scarica i file in una directory tmp. Puoi specificare un percorso relativo o un percorso completo. La variabile di ambiente $PWD non funziona qui.
- --platform multicloud Specifica che la piattaforma è diversa da Google Cloud, ad esempio on-premise o multi-cloud.
- --enable_all Consente allo script di:
  - Concedi le autorizzazioni IAM richieste.
  - Abilita le API Google richieste.
  - Imposta un'etichetta sul cluster che identifichi il mesh.
  - Registra il cluster nel parco risorse, se non è già registrato.
- -ca citadel Utilizza Istio CA come autorità di certificazione.
- --ca_cert Il certificato intermedio
- --ca_key La chiave per il certificato intermedio
- --root_cert Il certificato radice
- --cert_chain La catena di certificati
- --option stackdriver Attiva l'opzione Stackdriver. Tieni presente che puoi anche abilitare sia Stackdriver che Prometheus utilizzando --option prometheus-and-stackdriver.
- --option stackdriver cambia l'utilità di firma predefinita per istiod.

Microsoft AKS

Esegui questi comandi su Microsoft AKS per installare il piano di controllo con le funzionalità predefinite e Istio CA. Inserisci i valori nei segnaposto forniti.

Imposta il contesto corrente sul cluster di utenti:
```
kubectl config use-context CLUSTER_NAME
```
Corsa di asmcli install:
```
HUB_REGISTRATION_EXTRA_FLAGS=--has-private-issuer ./asmcli install \
  --fleet_id FLEET_PROJECT_ID \
  --kubeconfig KUBECONFIG_FILE \
  --output_dir DIR_PATH \
  --platform multicloud \
  --enable_all \
  --ca citadel \
  --ca_cert CA_CERT_FILE_PATH \
  --ca_key CA_KEY_FILE_PATH \
  --root_cert ROOT_CERT_FILE_PATH \
  --cert_chain CERT_CHAIN_FILE_PATH \
  --option stackdriver \
  --option attached-cluster
```
- HUB_REGISTRATION_EXTRA_FLAGS=--has-private-issuer Consente la registrazione con GKE Hub.
- --fleet_id L'ID del progetto progetto host del parco risorse.
- --kubeconfig Il percorso completo del file kubeconfig. La variabile di ambiente $PWD non funziona qui. Inoltre, le posizioni dei file kubeconfig relative che utilizzano un carattere `~` non funzioneranno.
- --output_dir Includi questa opzione per specificare una directory dove asmcli scarica anthos-service-mesh pacchetto ed estrae il file di installazione, contiene istioctl, esempi e manifest. Altrimenti asmcli scarica i file in una directory tmp. Puoi specificare un percorso relativo o un percorso completo. La variabile di ambiente $PWD non funziona qui.
- --platform multicloud Specifica che la piattaforma è diversa da Google Cloud, ad esempio on-premise o multi-cloud.
- --enable_all Consente allo script di:
  - Concedi le autorizzazioni IAM richieste.
  - Abilita le API Google richieste.
  - Imposta un'etichetta sul cluster che identifichi il mesh.
  - Registra il cluster nel parco risorse, se non è già registrato.
- -ca citadel Utilizza Istio CA come autorità di certificazione.
- --ca_cert Il certificato intermedio
- --ca_key La chiave per il certificato intermedio
- --root_cert Il certificato radice
- --cert_chain La catena di certificati
- --option stackdriver Attiva l'opzione Stackdriver. Tieni presente che puoi anche abilitare sia Stackdriver che Prometheus utilizzando --option prometheus-and-stackdriver.
- --option stackdriver cambia l'utilità di firma predefinita per istiod.

Installazione con funzionalità facoltative

Un file overlay è un file YAML contenente una risorsa personalizzata IstioOperator (CR) che viene passata a asmcli per configurare il piano di controllo. Puoi override la configurazione predefinita del piano di controllo e attivare una funzionalità facoltativa passando il file YAML a asmcli. Puoi applicare altri overlay e ogni file di overlay sostituisce la configurazione dei livelli precedenti. Come best practice, consigliamo di salvare i file di overlay nel sistema di controllo delle versioni.

Esistono due opzioni per attivare le funzionalità facoltative: --option e --custom_overlay.

Utilizza --option se non devi modificare il file di overlay. Con questo metodo, asmclirecupera il file dal Repository GitHub per te.

Usa --custom_overlay quando devi personalizzare il file dell'overlay.

Per ulteriori informazioni, consulta Attivare le funzionalità facoltative nel piano di controllo in-cluster.

Esegui i seguenti comandi su Google Distributed Cloud (solo software) per VMware, Google Distributed Cloud (solo software) per bare metal, GKE su AWS, GKE su Azure, Amazon EKS o Microsoft AKS. Inserisci i valori nei segnaposto forniti.

Imposta il contesto corrente sul cluster di utenti:
```
kubectl config use-context CLUSTER_NAME
```
Esegui asmcli install per installare il piano di controllo con un'istanza funzionalità. Per aggiungere più file, specifica --custom_overlay e il nome del file, ad esempio: --custom_overlayoverlay_file1.yaml --custom_overlay overlay_file2.yaml --custom_overlay overlay_file3.yaml
```
./asmcli install \
--fleet_id FLEET_PROJECT_ID \
--kubeconfig KUBECONFIG_FILE \
--output_dir DIR_PATH \
--platform multicloud \
--enable_all \
--ca mesh_ca \
--custom_overlay OVERLAY_FILE
```
- --fleet_id L'ID del progetto progetto host del parco risorse.
- --kubeconfig Il percorso completo del file kubeconfig. La variabile di ambiente $PWD non funziona qui. Inoltre, le posizioni dei file kubeconfig relative che utilizzano un carattere `~` non funzioneranno.
- --output_dir Includi questa opzione per specificare una directory dove asmcli scarica anthos-service-mesh pacchetto ed estrae il file di installazione, contiene istioctl, esempi e manifest. Altrimenti asmcli scarica i file in una directory tmp. Puoi specificare un percorso relativo o un percorso completo. La variabile di ambiente $PWD non funziona qui.
- --platform multicloud specifica che la piattaforma è qualcosa diverso da Google Cloud, ad esempio on-premise o multi-cloud.
- --enable_all Consente allo script di:
  - Concedi le autorizzazioni IAM richieste.
  - Abilita le API Google richieste.
  - Imposta un'etichetta sul cluster che identifichi il mesh.
  - Registra il cluster nel parco risorse, se non è già registrato.
- --ca mesh_ca Utilizza l'autorità di certificazione Cloud Service Mesh come autorità di certificazione. Tieni presente che asmcliconfigura Autorità di certificazione Cloud Service Mesh da utilizzare flotta Workload Identity
- --custom_overlay Specifica il nome del file di overlay.

Installa gateway

Cloud Service Mesh ti offre la possibilità di eseguire il deployment e gestire i gateway all'interno del tuo mesh di servizi. Un gateway descrive un bilanciatore del carico che opera all'esterno della rete mesh e riceve connessioni HTTP/TCP in entrata o in uscita. I gateway sono Envoy che forniscono un controllo granulare sul traffico in entrata e escono dalla rete.

Crea un nome di spazio per il gateway di ingresso se non ne hai già uno. I gateway sono carichi di lavoro utente e, come best practice, non devono essere eseguiti nel spazio dei nomi del piano di controllo. Sostituisci GATEWAY_NAMESPACE con il nome dello spazio dei nomi.
```
kubectl create namespace GATEWAY_NAMESPACE
```
Output previsto:
```
namespace/GATEWAY_NAMESPACE created
```
Attiva l'iniezione automatica sul gateway. I passaggi richiesti variano a seconda che vuoi utilizzare etichette di inserimento predefinite (ad es. istio-injection=enabled) o etichetta di revisione sul gateway nello spazio dei nomi. Il tag di revisione e l'etichetta di revisione predefiniti vengono utilizzati webhook di inserimento del sidecar per associare i proxy inseriti a un determinato la revisione del piano di controllo.
Predefinito (opzione consigliata)
1. Se hai utilizzato una revisione del tag predefinita per attivare l'iniezione automatica sul gateway, verifica che il tag predefinito esista nella directory specificata in --output_dir e che punti alla revisione appena installata.
  DIR_PATH/istioctl tag list
2. Applica le etichette di inserimento predefinite allo spazio dei nomi.
  kubectl label namespace GATEWAY_NAMESPACE istio-injection=enabled istio.io/rev-
Etichetta di revisione
1. Utilizza il seguente comando per individuare l'etichetta di revisione su istiod:
  kubectl get deploy -n istio-system -l app=istiod -o \ "jsonpath={.items[*].metadata.labels['istio\.io/rev']}{'\n'}"
  Il comando restituisce l'etichetta di revisione che corrisponde Versione di Cloud Service Mesh, ad esempio: asm-1215-12
2. Applica l'etichetta di revisione allo spazio dei nomi. Nel comando seguente, REVISION è il valore della revisione istiod che hai annotato nel passaggio precedente.
  kubectl label namespace GATEWAY_NAMESPACE \ istio.io/rev=REVISION --overwrite
  Risultato previsto:
  namespace/GATEWAY_NAMESPACE labeled
Puoi ignorare il messaggio "istio.io/rev" not found nel come output. Ciò significa che in precedenza lo spazio dei nomi non aveva Etichetta istio.io/rev, prevista nelle nuove installazioni di Cloud Service Mesh o nuovi deployment. Poiché l'iniezione automatica non va a buon fine se uno spazio dei nomi ha sia l'etichetta istio.io/rev sia l'etichetta istio-injection, tutti i comandi kubectl label nella documentazione di Cloud Service Mesh specificano esplicitamente entrambe le etichette.

Se lo spazio dei nomi del gateway non è etichettato, i pod istio-ingressgateway non andranno a buon fine con un errore ImagePullBackOff quando il gateway tenta di estrarre l'immagine auto. Questa immagine deve essere sostituita dal webhook.
Scarica il file di configurazione .yaml del gateway in entrata di esempio dal Repository anthos-service-mesh-packages.

Applica la configurazione .yaml del gateway in entrata di esempio così com'è o modificala come necessaria.

kubectl apply -n GATEWAY_NAMESPACE \
  -f CONFIG_PATH/istio-ingressgateway

Output previsto:

deployment.apps/istio-ingressgateway created
poddisruptionbudget.policy/istio-ingressgateway created
horizontalpodautoscaler.autoscaling/istio-ingressgateway created
role.rbac.authorization.k8s.io/istio-ingressgateway created
rolebinding.rbac.authorization.k8s.io/istio-ingressgateway created
service/istio-ingressgateway created
serviceaccount/istio-ingressgateway created

Scopri di più sulle best practice per i gateway.

Esegui il deployment e il nuovo deployment dei carichi di lavoro

Cloud Service Mesh utilizza i proxy sidecar per migliorare la sicurezza, l'affidabilità e l'osservabilità della rete. Con Cloud Service Mesh, queste funzioni vengono rimosse dal contenitore principale dell'applicazione e implementate in un proxy out-of-process comune fornito come contenitore separato nello stesso pod.

L'installazione non è completa finché non attivi l'iniezione automatica del proxy sidecar (iniezione automatica) e riavvii i pod per tutti i carichi di lavoro in esecuzione sul cluster prima dell'installazione di Cloud Service Mesh.

Per attivare l'iniezione automatica, etichetta i tuoi spazi dei nomi con le etichette di iniezione predefinite se è configurato il tag predefinito o con un'etichetta di revisione impostata su istiod quando hai installato Cloud Service Mesh. Il tag revisione e l'etichetta revisione predefiniti vengono utilizzati dall'webhook di iniezione di sidecar per associare i sidecar iniettati a una revisione istiod. Dopo aver aggiunto l'etichetta, i pod esistenti nello spazio dei nomi devono essere riavviati per poter inserire i file collaterali.

Prima di eseguire il deployment di nuovi carichi di lavoro in un nuovo spazio dei nomi, assicurati di configurare l'iniezione automatica in modo che Cloud Service Mesh possa monitorare e proteggere il traffico.

I passaggi necessari per attivare l'iniezione automatica dipendono dal fatto che tu voglia utilizzare le etichette di inserimento predefinite o l'etichetta di revisione:
Predefinita (opzione consigliata)
1. Se hai utilizzato una revisione del tag predefinita per attivare l'iniezione automatica sul gateway, verifica che il tag predefinito esista nella directory specificata in --output_dir e che punti alla revisione appena installata.
  DIR_PATH/istioctl tag list
2. Esegui questo comando. NAMESPACE è il nome dello spazio dei nomi in cui vuoi attivare l'iniezione automatica.
  kubectl label namespace NAMESPACE istio-injection=enabled istio.io/rev-
Le etichette di inserimento predefinite inseriscono la revisione a cui fa riferimento il tag predefinito.
Etichetta revisione
1. Utilizza il seguente comando per individuare l'etichetta di revisione su istiod:
  kubectl -n istio-system get pods -l app=istiod --show-labels
  L'output è simile al seguente:
  NAME READY STATUS RESTARTS AGE LABELS istiod-asm-1215-12-5788d57586-bljj4 1/1 Running 0 23h app=istiod,istio.io/rev=asm-1215-12,istio=istiod,pod-template-hash=5788d57586 istiod-asm-1215-12-5788d57586-vsklm 1/1 Running 1 23h app=istiod,istio.io/rev=asm-1215-12,istio=istiod,pod-template-hash=5788d57586
  Nell'output, sotto la colonna LABELS, prendi nota del valore del parametro istiod etichetta di revisione, che segue il prefisso istio.io/rev=. In questo esempio, Il valore è asm-1215-12.
2. Applica l'etichetta di revisione e rimuovi l'etichetta istio-injection, se esistente. Nel comando seguente, NAMESPACE è il nome dello spazio dei nomi per cui vuoi abilitare l'inserimento automatico REVISION è l'etichetta di revisione che hai annotato in passaggio precedente.
  kubectl label namespace NAMESPACE istio-injection- istio.io/rev=REVISION --overwrite
  Puoi ignorare il messaggio "istio-injection not found" nell'output. Ciò significa che in precedenza lo spazio dei nomi non aveva l'etichetta istio-injection, che dovresti aspettarti nelle nuove installazioni di Cloud Service Mesh o nei nuovi deployment. Poiché l'inserimento automatico il comportamento non è definito quando uno spazio dei nomi ha sia istio-injection e l'etichetta di revisione, tutti i comandi kubectl label nella La documentazione di Cloud Service Mesh assicura esplicitamente che ne sia impostata una sola.
Se i carichi di lavoro erano in esecuzione sul cluster prima dell'installazione di Cloud Service Mesh, riavvia i pod per attivare la reintegrazione.

La modalità di riavvio dei pod dipende dall'applicazione e dall'ambiente in cui si trova il cluster. Ad esempio, nell'ambiente di staging, potresti semplicemente eliminare tutti i pod, che verranno riavviati. Ma nella tua produzione potrebbe essere presente un processo che implementa deployment blu/verde in modo da poter riavviare in sicurezza i pod per evitare interruzioni del traffico.

Puoi utilizzare kubectl per eseguire un riavvio graduale:
```
kubectl rollout restart deployment -n NAMESPACE
```

Passaggi successivi

Se il mesh è costituito da cluster esterni a Google Cloud, consulta Configura un mesh multi-cluster all'esterno di Google Cloud.
Configura un indirizzo IP esterno on-premise.
Esegui il deployment dell'applicazione di esempio Online Boutique.

Installa Cloud Service Mesh per i carichi di lavoro Kubernetes fuori da Google Cloud

Limitazioni

Prima di iniziare

Ruoli richiesti per installare Cloud Service Mesh nel cluster

Installa Cloud Service Mesh

Installa le funzionalità predefinite e Mesh CA

On-premise

AWS

Azure

Amazon EKS

Microsoft AKS

Installa le funzionalità predefinite e il servizio dell'autorità di certificazione (CA)

Configura CA Service

policy.yaml

Configura Cloud Service Mesh per utilizzare il servizio CA

Installa le funzionalità predefinite con Istio CA

On-premise

AWS

Pubblico

Privato

Azure

Pubblico

Privato

Amazon EKS

Microsoft AKS

Installa con Istio CA con Google Cloud Observability abilitato

On-premise

AWS

Pubblico

Privato

Azure

Pubblico

Privato

Amazon EKS

Microsoft AKS

Installazione con funzionalità facoltative

Installa gateway

Predefinito (opzione consigliata)

Etichetta di revisione

Esegui il deployment e il nuovo deployment dei carichi di lavoro

Predefinita (opzione consigliata)

Etichetta revisione

Passaggi successivi