Questa pagina contiene una panoramica di Google Cloud CLI e dei relativi pattern di comando e funzionalità comuni.
Che cos'è gcloud CLI?
Google Cloud CLI è un insieme di strumenti per creare e gestire le risorse Google Cloud. Puoi usare questi strumenti per eseguire molte delle attività comuni sulla piattaforma dalla riga di comando o mediante script e altre opzioni di automazione.
Ad esempio, puoi utilizzare gcloud CLI per creare e gestire quanto segue:
- Istanze di macchine virtuali Compute Engine e altre risorse
- Istanze Cloud SQL
- Cluster di Google Kubernetes Engine
- Cluster e job Dataproc
- Zone gestite e set di record di Cloud DNS
- Deployment di Cloud Deployment Manager
Puoi utilizzare gcloud CLI anche per eseguire il deployment delle applicazioni App Engine, gestire l'autenticazione, personalizzare la configurazione locale ed eseguire altre attività.
Scarica e installa gcloud CLI
L'attuale versione di gcloud CLI è 481.0.0.
Anche se consigliamo vivamente di utilizzare la versione corrente dellgcloud CLI, puoi anche scaricare e installare le versioni precedenti dall'archivio dei download.
Se utilizzi Cloud Shell, gcloud CLI è disponibile automaticamente e non è necessario installarlo. In caso contrario, scarica e installa gcloud CLI, quindi initialize.
Per impostazione predefinita, gcloud CLI installa
i comandi al livello di disponibilità generale. Nei componenti dell'gcloud CLI sono disponibili funzionalità aggiuntive denominate alpha e beta. Questi componenti consentono di utilizzare gcloud CLI per lavorare con Bigtable, Dataflow e altre parti di Google Cloud a livelli di release precedenti rispetto alla disponibilità generale.
Scheda di riferimento di gcloud CLI
Per una rapida introduzione a gcloud CLI, un elenco dei comandi di uso comune e una panoramica della loro struttura, consulta la scheda di riferimento dell'interfaccia a riga di comando gcloud.
Livelli di release
I comandi dellgcloud CLI hanno i seguenti livelli di release:
| Livello di release | Etichetta | Descrizione |
|---|---|---|
| Disponibilità generale | Nessuna | I comandi sono considerati completamente stabili e disponibili per l'uso in produzione. Per un preavviso relativo alle modifiche ai comandi che interrompono la funzionalità corrente, consulta le note di rilascio. |
| Beta | beta |
I comandi sono completi dal punto di vista funzionale, ma potrebbero comunque presentare alcuni problemi in sospeso. Le modifiche che interrompono questi comandi possono essere apportate senza preavviso. |
| Alpha | alpha |
I comandi sono in una versione anticipata e potrebbero cambiare senza preavviso. |
I componenti alpha e beta non sono installati per impostazione predefinita quando installi gcloud CLI. Devi installare questi componenti separatamente utilizzando il comando gcloud components install. Se provi a eseguire un comando alpha o beta e il componente corrispondente non è installato, l'interfaccia alla gcloud CLI richiede di installarlo.
Gruppi di comandi
All'interno di ogni livello di release, i comandi gcloud CLI sono organizzati in una gerarchia nidificata di gruppi di comandi, ognuno dei quali rappresenta un prodotto o una funzionalità di Google Cloud o dei suoi sottogruppi funzionali.
Ad esempio:
| Gruppo di comandi | Descrizione |
|---|---|
gcloud compute |
Comandi relativi a Compute Engine in disponibilità generale |
gcloud compute instances |
Comandi relativi alle istanze di Compute Engine in disponibilità generale |
gcloud beta compute |
Comandi correlati a Compute Engine in versione beta |
gcloud alpha app |
Comandi correlati alla gestione dei deployment di App Engine in versione alpha |
Esecuzione dei comandi dell'interfaccia a riga di comando gcloud
Puoi eseguire i comandi dell'interfaccia a riga della gcloud CLI dalla riga di comando e da script e altre automazioni, ad esempio quando utilizzi Jenkins per automatizzare le attività di Google Cloud.
Proprietà
Le proprietà dell'interfaccia a riga di comando di gcloud sono impostazioni che influiscono sul comportamento degli strumenti di gcloud CLI. Alcune di queste proprietà possono essere impostate da opzioni globali o di comando, nel qual caso il valore impostato dall'opzione ha la precedenza.
Attivazione delle funzioni di accessibilità
Per un'esperienza più semplice con lo screen reader, gcloud CLI viene fornito con una proprietà accessibility/screen_reader.
Per attivare la proprietà di accessibilità, esegui:
gcloud config set accessibility/screen_reader true
Per ulteriori dettagli sulle funzioni di accessibilità fornite con lo strumento a riga di comando gcloud, consulta la guida Attivazione delle funzioni di accessibilità.
Configurazioni
Una configurazione è un insieme di proprietà gcloud CLI. Una configurazione funziona come un profilo.
Quando inizierai a utilizzare gcloud CLI, lavorerai con un'unica configurazione denominata default e potrai impostare le proprietà eseguendo gcloud init o gcloud config set. Questa singola configurazione predefinita
è adatta alla maggior parte dei casi d'uso.
Per lavorare con più progetti o account di autorizzazione, puoi impostare più configurazioni con gcloud config configurations create e cambiare le configurazioni. All'interno di una configurazione, puoi personalizzare le proprietà.
Ad esempio, per impostare il progetto all'interno di una configurazione attiva,
utilizza la proprietà project:
gcloud config set project <project-id>
Per un account dettagliato di questi concetti, consulta la Guida alle configurazioni.
Opzioni globali
gcloud CLI fornisce un insieme di opzioni dell'interfaccia a riga di comando gcloud che regolano il comportamento dei comandi a livello di ogni chiamata. Le opzioni sostituiscono i valori impostati nelle proprietà gcloud CLI.
Argomenti e opzioni di posizionamento
Sebbene gli argomenti e le opzioni posizionali influiscano sull'output di un comando gcloud CLI, c'è una sottile differenza nei loro casi d'uso. Un argomento posizionale viene utilizzato per definire un'entità su cui opera un comando, mentre è necessaria un'opzione per impostare una variante del comportamento di un comando.
Utilizzo di stdout e stderr
L'output dei comandi gcloud CLI riusciti viene scritto in stdout. Tutti gli altri tipi di risposte (richieste, avvisi ed errori) vengono scritti in stderr. Non scrivere script in base a risposte scritte in stderr perché
queste risposte non sono stabili.
Per le linee guida sulla gestione dell'output, consulta la Guida allo scripting.
Prompt
Per proteggerti da azioni distruttive non intenzionali, gcloud CLI
conferma le tue intenzioni prima di eseguire comandi come
gcloud projects delete.
È possibile che ti venga chiesto di fornire ulteriori informazioni.
Ad esempio, ti verrà chiesto di scegliere una zona quando crei un'istanza di una macchina virtuale Compute Engine utilizzando gcloud compute instances create test-instance.
Per disattivare i prompt, utilizza l'opzione --quiet.
Non scrivere script in base alla formulazione dei prompt, perché queste possono cambiare.
Eliminazione dei prompt, scrittura nel terminale e logging
L'opzione --quiet (anche -q) per
gcloud CLI
disattiva tutti i prompt interattivi durante l'esecuzione dei comandi gcloud CLI
ed è utile per lo scripting. Se sono necessari input, vengono utilizzati i valori predefiniti. Se non è presente un valore predefinito, viene generato un errore.
Per eliminare la stampa dell'output comando nell'output standard e nell'errore standard nel terminale, utilizza l'opzione --no-user-output-enabled.
Per regolare il livello di dettaglio dei log, specifica un livello di dettaglio (debug, informazioni, avviso, errore, critico o nessuno) utilizzando l'opzione --verbosity.
Determinazione della struttura di output
Per impostazione predefinita, quando un comando gcloud CLI restituisce un elenco di risorse, le risorse vengono stampate nell'output standard. Per produrre un output più significativo, le opzioni format, filter e projection consentono di perfezionare l'output.
Per definire solo il formato dell'output, utilizza l'opzione --format per produrre una versione tabulare o bidimensionale dell'output (per la visualizzazione interattiva) o una versione leggibile dalla macchina (json, csv, yaml, value).
Per formattare un elenco di chiavi che selezionano i valori dei dati delle risorse, utilizza projections. Per perfezionare ulteriormente
l'output in base a criteri che hai definito, utilizza
filter.
Per acquisire familiarità con la funzionalità di filtro e formattazione, puoi completare un breve tutorial interattivo facendo clic su Apri in Cloud Shell.
Passaggi successivi
- Scopri di più sui comandi dell'interfaccia a riga di comando gcloud CLI nella documentazione di riferimento dell'interfaccia a riga di comando gcloud.