Riferimento asmcli
Questa pagina descrive gli argomenti disponibili per asmcli
.
Opzioni
Identifica il cluster Hai a disposizione le seguenti opzioni per identificare il cluster:
Solo GKE
-p|--project_id CLUSTER_PROJECT_ID
- L'ID progetto in cui è stato creato il cluster.
-n|--cluster_name CLUSTER_NAME
- Il nome del cluster.
-l|--cluster_location CLUSTER_LOCATION
- La zona (per i cluster a zona singola) o la regione (per i cluster regionali) in cui è stato creato il cluster.
Tutte le piattaforme
--kubeconfig KUBECONFIG_FILE
Il percorso completo del file kubeconfig. La variabile di ambiente $PWD
non funziona qui.
--ctx|--context KUBE_CONTEXT
Il contesto kubeconfig da utilizzare. Se non specificato,
asmcli
utilizza il contesto predefinito.
-c|--ca {mesh_ca|gcp_cas|citadel}
L'autorità di certificazione (CA) da utilizzare per gestire i certificati TLS reciproci. Specifica
mesh_ca
per utilizzare l'autorità di certificazione Cloud Service Mesh,gcp_cas
per utilizzare Certificate Authority Service ocitadel
per utilizzare l'autorità di certificazione Istio. Cloud Service Mesh gestito non supporta Istio CA. Per ulteriori informazioni, consulta quanto segue:--co|--custom_overlay OVERLAY_FILE
Utilizza
--custom_overly
con il nome di un file YAML (chiamato file overlay) contenente la risorsa personalizzataIstioOperator
per configurare il piano di controllo all'interno del cluster. Specifichi un file overlay per attivare una funzionalità che non è attiva per impostazione predefinita. Cloud Service Mesh gestito non supporta l'APIIstioOperator
, pertanto non puoi utilizzare--custom_overlay
per configurare il control plane gestito.asmcli
deve essere in grado di individuare il file overlay, quindi deve trovarsi nella stessa directory diasmcli
o puoi specificare un percorso relativo. Per aggiungere più file, specifica--co|--custom_overlay
e il nome del file, ad esempio:--co overlay_file1.yaml --co overlay_file2.yaml --co overlay_file3.yaml
--hub-registration-extra-flags HUB_REGISTRATION_EXTRA_FLAGS
Se utilizzi cluster Amazon EKS collegati, utilizza
--hub-registration-extra-flags
per registrare il cluster nel parco risorse se non è già registrato.-k|--key_file FILE_PATH
Il file della chiave di un account di servizio. Ometti questa opzione se non utilizzi un account di servizio.
--network_id NETWORK_ID
Utilizza
--network_id
per impostare l'etichettatopology.istio.io/network
applicata allo spazio dei nomiistio-system
. Per GKE,--network_id
è impostato per impostazione predefinita sul nome della rete del cluster. Per altri ambienti, verrà utilizzatodefault
.-o|--option OVERLAY_FILE
Il nome del file overlay (senza l'estensione
.yaml
) cheasmcli
scarica dal repositoryanthos-service-mesh
per attivare una funzionalità facoltativa. Per utilizzare--option
è necessaria una connessione a internet. Le opzioni--option
e--custom_overlay
sono simili, ma hanno un comportamento leggermente diverso:Utilizza
--custom_overlay
quando devi modificare le impostazioni nel file overlay.Utilizza
--option
per attivare una funzionalità che non richiede modifiche al file di overlay, ad esempio per configurare i criteri di audit per i tuoi servizi.
Per aggiungere più file, specifica
-o|--option
e il nome del file, ad esempio:-o option_file1 -o option_file2 -o option_file3
-D|--output_dir DIR_PATH
Se non specificato,
asmcli
crea una directory temporanea in cui scarica i file e le configurazioni necessari per l'installazione di Cloud Service Mesh. Specifica il flag--output-dir
per specificare un percorso relativo a una directory da utilizzare al suo posto. Al termine, la directory specificata contiene le sottodirectoryasm
eistio-1.23.3-asm.1
. La directoryasm
contiene la configurazione per l'installazione. La directoryistio-1.23.3-asm.1
contiene i contenuti estratti del file di installazione, che contieneistioctl
, Samples e manifest. Se specifichi--output-dir
e la directory contiene già i file necessari,--output-dir
li utilizza anziché scaricarli di nuovo.asmcli
--platform PLATFORM {gcp|multicloud}
La piattaforma o il provider del cluster Kubernetes. Il valore predefinito è
gcp
(per i cluster GKE). Per tutte le altre piattaforme,multicloud
.-r|--revision_name REVISION NAME
Un'etichetta di revisione è una coppia chiave-valore impostata sul piano di controllo. La chiave dell'etichetta di revisione è sempre
istio.io/rev
. Per impostazione predefinita,asmcli
imposta il valore per l'etichetta della revisione in base alla versione di Cloud Service Mesh, ad esempioasm-1233-2
. Includi questa opzione se vuoi sostituire il valore predefinito e specificarne uno personalizzato. L'argomentoREVISION NAME
deve essere una etichetta DNS-1035. Ciò significa che il nome deve:- Deve contenere massimo 63 caratteri
- Deve contenere solo caratteri alfanumerici minuscoli o il trattino "-".
- Deve iniziare con un carattere alfabetico
- Deve terminare con un carattere alfanumerico
La regex utilizzata per la convalida è: '[a-z]([-a-z0-9]*[a-z0-9])?'
-s|--service_account ACCOUNT
- Il nome di un account di servizio utilizzato per installare Cloud Service Mesh. Se non viene specificato, viene utilizzato l'account utente attivo nella configurazione
gcloud
corrente. Se devi modificare l'account utente attivo, esegui gcloud auth login.
Opzioni per il certificato personalizzato della CA Istio
Se hai specificato --ca citadel
e utilizzi una CA personalizzata, includi le seguenti opzioni:
--ca_cert FILE_PATH
: il certificato intermedio--ca_key FILE_PATH
: la chiave per il certificato intermedio--root_cert FILE_PATH
: il certificato radice--cert_chain FILE_PATH
: la catena di certificati
Per ulteriori informazioni, consulta Collegare certificati CA esistenti.
Flag di attivazione
I flag che iniziano con --enable
consentono a asmcli
di attivare le API Google richieste, impostare le autorizzazioni IAM (Identity and Access Management) richieste e aggiornare il cluster. Se preferisci, puoi
aggiornare il progetto e il cluster
prima di eseguire asmcli
. Tutti gli indicatori di attivazione non sono compatibili con
asmcli validate
. Se specifichi un flag di attivazione quando esegui
asmcli validate
, il comando termina con un errore.
-e|--enable_all
- Consenti a
asmcli
di eseguire tutte le singole azioni di attivazione descritte di seguito. --enable_cluster_roles
- Consenti a
asmcli
di tentare di associare l'account utente o di servizio Google Cloud che esegueasmcli
al ruolocluster-admin
nel tuo cluster.asmcli
determina l'account utente dal comandogcloud config get core/account
. Se eseguiasmcli
localmente con un account utente, assicurati di chiamare il comandogcloud auth login
prima di eseguireasmcli
. Se devi modificare l'account utente, esegui il comandogcloud config set core/account GCP_EMAIL_ADDRESS
dove GCP_EMAIL_ADDRESS è l'account che utilizzi per accedere a Google Cloud. --enable_cluster_labels
- Consenti a
asmcli
di impostare le etichette del cluster richieste. --enable_gcp_components
Consenti a
asmcli
di attivare i seguenti componenti e servizi gestiti Google Cloud obbligatori:Workload Identity, che consente alle applicazioni GKE di accedere in sicurezza ai servizi Google Cloud.
--enable_gcp_apis
Consenti a
asmcli
di attivare tutte le API Google richieste.--enable_gcp_iam_roles
Consenti a
asmcli
di impostare le autorizzazioni IAM richieste.--enable_meshconfig_init
Consenti allo script di inizializzare l'endpoint meshconfig per tuo conto. Sottinteso da
--enable_gcp_components
e--managed
.--enable_namespace_creation
Consenti a
asmcli
di creare lo spazio dei nomiistio-system
principale.--enable_registration
Consenti a
asmcli
di registrare il cluster nel progetto in cui si trova. Se non includi questo flag, segui i passaggi descritti in Registrazione di un cluster per registrarlo manualmente. Tieni presente che, a differenza degli altri flag di abilitazione,--enable_registration
è incluso in--enable_all
solo quando specifichi un'opzione (ad esempio--option hub-meshca
) che richiede la registrazione del cluster. In caso contrario, devi specificare questo flag separatamente.
Altri flag
--dry_run
- Stampa i comandi, ma non eseguirli.
--fleet_id
- Registra un cluster in un parco risorse utilizzando l'ID progetto host del parco risorse. Questo flag è obbligatorio per i cluster non Google Cloud. Se non viene fornito per i cluster Google Cloud, viene utilizzato per impostazione predefinita l'ID progetto del cluster. Puoi eseguire
asmcli install
insieme a--fleet_id
prima dell'installazione o come parte dell'installazione passando i flag--enable-registration
e--fleet-id
. Questa impostazione non può essere modificata dopo la configurazione. --managed
- Esegui il provisioning di un piano di controllo gestito remoto anziché installarne uno in-cluster.
--offline
- Esegui un'installazione offline utilizzando il pacchetto pre-scaricato nella directory di output. Se la directory non è specificata o non contiene i file richiesti, lo script uscirà con un errore.
--only_enable
- Esegui i passaggi specificati per configurare l'utente/il cluster corrente, ma non installa nulla.
--only_validate
- Esegui la convalida, ma non aggiornare il progetto o il cluster e non installare Cloud Service Mesh. Questo flag non è compatibile con i
flag di abilitazione.
asmcli
termina con un errore se specifichi--only_validate
con un flag di attivazione. --print_config
- Anche se non installi Cloud Service Mesh, stampa tutto il codice YAML compilato nell'output standard (stdout). Tutto l'altro output viene scritto nell'errore standard
(stderr), anche se normalmente andrebbe in stdout.
asmcli
ignora tutte le verifiche e la configurazione quando specifichi questo flag. --disable_canonical_service
- Per impostazione predefinita,
asmcli
esegue il deployment del controller del servizio di canonicalizzazione nel tuo cluster. Se non vuoi cheasmcli
esegui il deployment del controller, specifica--disable_canonical_service
. Per ulteriori informazioni, consulta Abilitazione e disattivazione del controller del servizio di canonicalizzazione. -h|--help
- Mostra un messaggio di aiuto che descrive le opzioni e i flag ed esce.
--use_managed_cni
- Utilizza il CNI gestito. Se questo flag non viene passato,
asmcli
applicherà i manifest CNI statici. --use_vpcsc
- Questo flag non è più necessario per utilizzare Controlli di servizio VPC per il tuo progetto.
-v|--verbose
Durante l'esecuzione, - stampa il comando che verrà eseguito successivamente.
asmcli
Con il--verbose
flag,asmcli
stampa il comando anche dopo l'esecuzione. --version
- Stampa la versione di
asmcli
ed esci. Se non hai la versione più recente, puoi scaricarla.asmcli_1.23
Passaggi successivi
Scopri come configurare un mesh multi-cluster:
Se il tuo mesh è costituito interamente da cluster GKE, consulta Configurare un mesh multi-cluster su GKE.
Se il tuo mesh è costituito da cluster esterni a Google Cloud, consulta Configurare un mesh multi-cluster al di fuori di Google Cloud.
Esegui il deployment dell'applicazione di esempio Online Boutique