Questa pagina contiene una panoramica di Google Cloud CLI e i suoi modelli di comando e le sue funzionalità comuni.
Che cos'è gcloud CLI?
Google Cloud CLI è un insieme di strumenti per creare e gestire dell'accesso a specifiche risorse Google Cloud. Puoi usare questi strumenti per eseguire molte le attività della piattaforma dalla riga di comando o tramite 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 anche utilizzare gcloud CLI per eseguire il deployment di App Engine applicazioni, gestire l'autenticazione, personalizzare la configurazione locale ed eseguire altre attività.
Scarica e installa gcloud CLI
L'attuale versione della gcloud CLI è 488.0.0.
Anche se consigliamo vivamente di utilizzare la versione corrente gcloud CLI, puoi anche scaricare e installare le versioni precedenti dall'archivio dei download.
Se utilizzi Cloud Shell, è disponibile gcloud CLI automaticamente senza bisogno di installarla. Altrimenti, scaricare e installare gcloud CLI e quindi inizializzarlo.
Per impostazione predefinita, gcloud CLI installa
disponibili al livello di disponibilità generale. Sono disponibili ulteriori funzionalità
disponibili in gcloud CLI
componenti denominati alpha
e beta
. Questi componenti
ti consentono di utilizzare gcloud CLI per lavorare con Bigtable,
Dataflow e altre parti di Google Cloud in una release precedente
rispetto alla disponibilità generale.
Scheda di riferimento di gcloud CLI
Per una rapida introduzione a gcloud CLI, è riportato un elenco usati e vedremo come sono strutturati, consulta le Scheda di riferimento dell'interfaccia a riga di comando gcloud.
Livelli di release
I comandi della gcloud CLI hanno i seguenti livelli di release:
Livello di release | Etichetta | Descrizione |
---|---|---|
Disponibilità generale | Nessuno | I comandi sono considerati completamente stabili e disponibili per la produzione per gli utilizzi odierni. Per preavviso di modifiche ai comandi che interrompono la corrente di tutte le funzionalità, note di rilascio. |
Beta | beta |
I comandi sono completi dal punto di vista funzionale, ma potrebbero esserci ancora alcuni errori che le applicazioni presentino problemi di prestazioni. 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 vengono installati per impostazione predefinita al momento dell'installazione
con gcloud CLI. Devi installare questi componenti
usando il comando gcloud components install
. Se provi a eseguire un
il comando alpha o beta e il componente corrispondente non sono installati,
l'interfaccia a riga di comando gcloud ti chiede di installarla.
Gruppi di comandi
All'interno di ogni livello di release, i comandi della gcloud CLI sono organizzati in un una gerarchia nidificata di gruppi di comandi, ognuno dei quali rappresenta un prodotto 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 della gcloud CLI
Puoi eseguire i comandi della gcloud CLI dalla riga di comando da script e altre automazioni, ad esempio esempio di usare Jenkins per automatizzare le attività di Google Cloud.
Proprietà
Le proprietà dell'interfaccia a riga di comando gcloud sono impostazioni influisce sul comportamento di gcloud CLI i nostri strumenti. Alcune di queste proprietà possono essere impostate o le opzioni di comando, nel qual caso il valore impostato dall'opzione ha la precedenza.
Attivazione delle funzioni di accessibilità
Per un'esperienza più semplice con gli screen reader, gcloud CLI
include una proprietà accessibility/screen_reader
.
Per attivare la proprietà di accessibilità, esegui:
gcloud config set accessibility/screen_reader true
Per maggiori dettagli sulle funzioni di accessibilità fornite con lo strumento gcloud a strumento a riga di comando, consulta Attivare le funzioni di accessibilità guida.
Configurazioni
Una configurazione è un insieme di proprietà della gcloud CLI. R funziona come un profilo.
Quando inizierai a utilizzare gcloud CLI, lavorerai con una singola
denominata default
e puoi impostare le proprietà eseguendo
gcloud init
o gcloud config set
. Questa singola configurazione predefinita è
adatti alla maggior parte dei casi d'uso.
Per lavorare con più progetti o account di autorizzazione, puoi configurare
più configurazioni con gcloud config configurations create
e switch
tra le configurazioni. All'interno di una configurazione, puoi personalizzare le proprietà.
Ad esempio, per impostare il progetto all'interno di una configurazione attiva,
usa la proprietà project
:
gcloud config set project <project-id>
Per un resoconto dettagliato di questi concetti, consulta Guida alle configurazioni.
Opzioni globali
gcloud CLI fornisce un insieme Opzioni dell'interfaccia a riga di comando gcloud che regolano il comportamento dei comandi a livello di ogni chiamata. Override delle opzioni e i valori impostati nelle proprietà di gcloud CLI.
Argomenti e opzioni di posizionamento
Mentre gli argomenti e le opzioni posizionali influiscono sull'output di un con il comando gcloud CLI, esiste una sottile differenza d'uso diversi. Un argomento posizionale viene utilizzato per definire un'entità su cui un comando mentre è necessaria un'opzione per impostare una variazione nel comportamento di un comando.
Utilizzo di stdout
e stderr
L'output dei comandi gcloud CLI riusciti viene scritto
stdout
. Tutti gli altri tipi di risposte (prompt, avvisi ed errori) vengono
scritto in stderr
. Non scrivere script in base a risposte scritte a stderr
perché
queste risposte non sono stabili.
Per le linee guida sulla gestione dell'output, consulta Guida allo script.
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 Compute Engine
di macchina virtuale con 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
disabilita 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 ci sono
non è un valore predefinito, viene generato un errore.
Per eliminare la stampa dell'output comando nell'output standard e nell'errore standard in
dal terminale, usa 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
--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 contenuti
l'output, le opzioni format
, filter
e projection
consentono di perfezionare
l'output.
Per definire solo il formato dell'output, utilizza la classe
--format
per generare una tabella
o una versione bidimensionale dell'output (per la visualizzazione interattiva) oppure
una versione dell'output 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 definisci, utilizza
filter
Per acquisire familiarità con la funzionalità di filtro e formattazione, puoi completare una un tutorial interattivo rapido facendo clic su Apri in Cloud Shell.
Passaggi successivi
- Scopri di più sui comandi gcloud CLI nel Riferimento dell'interfaccia a riga di comando gcloud.