Questa pagina contiene una panoramica di Google Cloud CLI, dei relativi pattern di comando e delle funzionalità comuni.
Che cos'è gcloud CLI?
Google Cloud CLI è un insieme di strumenti per creare e gestire Google Cloud le risorse. Puoi utilizzare questi strumenti per eseguire molte delle attività più comuni sulla piattaforma dalla riga di comando o tramite script e altre automazioni.
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 delle applicazioni App Engine, gestire l'autenticazione, personalizzare la configurazione locale ed eseguire altre attività.
Scarica e installa gcloud CLI
La versione attuale di gcloud CLI è 562.0.0.
Sebbene ti consigliamo vivamente di utilizzare la versione attuale di gcloud CLI, puoi anche scaricare e installare le versioni precedenti dall' archivio di download.
Se utilizzi Cloud Shell, gcloud CLI è disponibile automaticamente e non devi installarlo. In caso contrario, scarica e installa gcloud CLI quindi inizializzalo.
Per impostazione predefinita, gcloud CLI installa i comandi a livello di disponibilità generale. Funzionalità aggiuntive sono
disponibili nei componenti gcloud CLI
denominati alpha e beta. Questi componenti
ti consentono di utilizzare gcloud CLI per lavorare con Bigtable,
Dataflow e altre parti di Google Cloud a livelli di rilascio
precedenti alla disponibilità generale.
La scheda di riferimento di gcloud CLI
Per una rapida introduzione a gcloud CLI, un elenco di comandi di uso comune e una panoramica della struttura di questi comandi, consulta la scheda di riferimento di gcloud CLI.
Livelli di rilascio
I comandi gcloud CLI hanno i seguenti livelli di rilascio:
| Livello di rilascio | Etichetta | Descrizione |
|---|---|---|
| Disponibilità generale | Nessuno | I comandi sono considerati completamente stabili e disponibili per l'uso in produzione use. Per ricevere un preavviso delle modifiche ai comandi che interrompono la funzionalità attuale consulta le note di rilascio. |
| Beta | beta |
I comandi sono funzionalmente completi, ma potrebbero ancora presentare alcuni problemi in sospeso. Le modifiche che provocano un errore a questi comandi possono essere apportate senza preavviso. |
| Alpha | alpha |
I comandi sono in fase di rilascio anticipato e potrebbero cambiare senza preavviso. |
I componenti alpha e beta non vengono 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, gcloud CLI ti chiede di installarlo.
Gruppi di comandi
All'interno di ogni livello di rilascio, i comandi gcloud CLI sono organizzati in una gerarchia nidificata di gruppi di comandi, ognuno dei quali rappresenta un prodotto o funzionalità di Google Cloud o i relativi 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 relativi a Compute Engine in versione beta |
gcloud alpha app |
Comandi relativi alla gestione dei deployment di App Engine in versione alpha |
Esecuzione dei comandi gcloud CLI
Puoi eseguire i comandi gcloud CLI dalla riga di comando e da script e altre automazioni, ad esempio quando utilizzi Jenkins per automatizzare le Google Cloud attività.
Proprietà
Le proprietà gcloud CLI sono impostazioni che influenzano il comportamento degli strumenti gcloud CLI. Alcune di queste proprietà possono essere impostate tramite opzioni globali o di comando, nel qual caso il valore impostato dall'opzione ha la precedenza.
Attivare le funzioni di accessibilità
Per un'esperienza più semplificata con lo 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 funzionalità di accessibilità incluse nello strumento a riga di comando gcloud, consulta la guida Attivare le funzioni di accessibilità.
Configurazioni
Una configurazione è un insieme di proprietà gcloud CLI. Una configurazione funziona come un profilo.
Quando inizi a utilizzare gcloud CLI, lavorerai con una singola 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 configurare più configurazioni con gcloud config configurations create e passare da una all'altra. 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 una descrizione dettagliata di questi concetti, consulta la guida Configurazioni.
Opzioni globali
gcloud CLI fornisce un insieme di opzioni gcloud CLI che regolano il comportamento dei comandi a livello di ogni chiamata. Le opzioni sostituiscono i valori impostati nelle proprietà gcloud CLI.
Argomenti e opzioni posizionali
Sebbene gli argomenti e le opzioni posizionali influiscano sull'output di un comando gcloud CLI, esiste una sottile differenza nei relativi casi d'uso. Un argomento posizionale viene utilizzato per definire un'entità su cui opera un comando, mentre un'opzione è necessaria per impostare una variazione nel 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 (prompt, avvisi ed errori) vengono scritti in stderr. Non creare script per le risposte scritte in stderr perché queste risposte non sono stabili.
Per le linee guida sulla gestione dell'output, consulta la guida alla creazione di script.
Elementi essenziali
Per proteggerti da azioni distruttive involontarie, gcloud CLI conferma le tue intenzioni prima di eseguire comandi come gcloud projects delete.
Potrebbe essere visualizzato un prompt quando sono necessarie informazioni aggiuntive.
Ad esempio, ti verrà chiesto di scegliere una zona quando crei un'istanza di macchina virtuale Compute Engine utilizzando gcloud compute instances create test-instance.
Per disattivare i prompt, utilizza l'opzione --quiet.
Non creare script per la formulazione dei prompt perché la formulazione può cambiare.
Eliminare i prompt, scrivere nel terminale e registrare
L'opzione --quiet (anche -q) per
gcloud CLI
disattiva tutti i prompt interattivi quando esegui i comandi gcloud CLI
ed è utile per la creazione di script. Se sono necessari input, vengono utilizzati i valori predefiniti. Se non esiste 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, info, warning, error, critical o none) utilizzando l'
--verbosity opzione.
Determinare la struttura dell'output
Per impostazione predefinita, quando un comando gcloud CLI restituisce un elenco di risorse, le risorse vengono stampate in modo leggibile nell'output standard. Per produrre un output più significativo, le opzioni format, filter e projection ti consentono di ottimizzare l'output.
Per definire solo il formato dell'output, utilizza l'
--format opzione per produrre una versione tabellare
o appiattita dell'output (per la visualizzazione interattiva) o
una versione leggibile dalla macchina dell'output (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 ai criteri definiti, utilizza
filter.
Passaggi successivi
- Scopri di più sui comandi gcloud CLI nel riferimento di gcloud CLI.