Panoramica dell'interfaccia a riga di comando gcloud

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Questa pagina contiene una panoramica di Google Cloud CLI e dei suoi pattern e funzionalità di comando comuni.

Che cos'è l'interfaccia a riga di comando gcloud?

Google Cloud CLI è un insieme di strumenti per creare e gestire le risorse di Google Cloud. Puoi utilizzare questi strumenti per eseguire molte delle attività più comuni sulla piattaforma, utilizzando la riga di comando oppure script e altre operazioni di automazione.

Ad esempio, puoi utilizzare l'interfaccia a riga di comando gcloud per creare e gestire quanto segue:

  • Istanze di macchine virtuali e altre risorse di Compute Engine
  • Istanze Cloud SQL
  • Cluster di Google Kubernetes Engine
  • Cluster e job Dataproc
  • Zone e set di record gestiti di Cloud DNS
  • Deployment di Cloud Deployment Manager

Puoi anche utilizzare l'interfaccia a riga di comando gcloud per eseguire il deployment di applicazioni App Engine, gestire l'autenticazione, personalizzare la configurazione locale ed eseguire altre attività.

Scheda di riferimento dell'interfaccia a riga di comando gcloud

Per una rapida introduzione all'interfaccia a riga di comando gcloud, un elenco di comandi di uso comune e una spiegazione di come sono strutturati, consulta la scheda di riferimento dell'interfaccia a riga di comando gcloud.

Scarica e installa l'interfaccia a riga di comando gcloud

Se utilizzi Cloud Shell, l'interfaccia a riga di comando gcloud è disponibile automaticamente e non è necessario installarla. In caso contrario, scarica e installa l'interfaccia a riga di comando gcloud, quindi inizializzalo.

Per impostazione predefinita, l'interfaccia a riga di comando gcloud installa i comandi che sono a livello di disponibilità generale. Sono disponibili funzionalità aggiuntive nei componenti dell'interfaccia a riga di comando gcloud: alpha e beta. Questi componenti consentono di utilizzare gcloud CLI per funzionare con Cloud Bigtable, Dataflow e altre parti di Google Cloud a livelli di release precedenti rispetto alla disponibilità generale.

La versione attuale dell'interfaccia a riga di comando gcloud è 416.0.0. Puoi scaricare e installare le versioni precedenti dell'interfaccia a riga di comando gcloud dall'archivio di download.

Livelli di release

I comandi dell'interfaccia a riga di comando gcloud hanno i seguenti livelli di rilascio:

Livello di release Etichetta Descrizione
Disponibilità generale Nessuno I comandi sono considerati completamente stabili e disponibili per l'uso in produzione. Per comunicare in anticipo le modifiche ai comandi che interrompono la funzionalità corrente, consulta le note di rilascio.
Beta beta I comandi sono funzionalmente completi, ma potrebbero comunque presentare alcuni problemi in sospeso. È possibile apportare modifiche a questi comandi senza preavviso.
Alpha alpha I comandi sono in anteprima e potrebbero cambiare senza preavviso.

I componenti alpha e beta non sono installati per impostazione predefinita quando si installa l'interfaccia a riga di comando gcloud. 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 a riga di comando gcloud richiede di installarlo.

Gruppi di comandi

All'interno di ogni livello di rilascio, i comandi dell'interfaccia a riga di comando 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 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 beta
gcloud alpha app Comandi relativi alla gestione dei deployment App Engine nella versione alpha

Esecuzione dei comandi dell'interfaccia a riga di comando gcloud

Puoi eseguire i comandi dell'interfaccia a riga di comando gcloud 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 gcloud sono impostazioni che influiscono sul comportamento degli strumenti dell'interfaccia a riga di comando gcloud. Alcune di queste proprietà possono essere impostate tramite opzioni globali o comandi, nel qual caso, il valore impostato dall'opzione ha la precedenza.

Attivazione delle funzioni di accessibilità

Per un'esperienza di screen reader più semplificata, l'interfaccia a riga di comando gcloud è dotata di 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 a riga di comando gcloud, consulta la guida sull'attivazione delle funzioni di accessibilità.

Configurazioni

Una configurazione è un insieme di proprietà dell'interfaccia a riga di comando gcloud. Una configurazione funziona come un profilo.

Quando inizi a utilizzare l'interfaccia a riga di comando gcloud, lavori con una singola configurazione denominata default e puoi 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 passare da una configurazione all'altra. Puoi personalizzare le proprietà all'interno di una configurazione. Ad esempio, per impostare il progetto in 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

L'interfaccia a riga di comando gcloud 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à dell'interfaccia a riga di comando gcloud.

Opzioni e argomenti posizionali

Anche se gli argomenti e le opzioni di posizione influiscono sull'output di un comando dell'interfaccia a riga di comando gcloud, c'è una piccola 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 variazione nel comportamento di un comando.

Utilizzo di stdout e stderr

L'output dei comandi dell'interfaccia a riga di comando gcloud riuscito è scritto in stdout. Tutti gli altri tipi di risposte (messaggi di avviso, avvisi ed errori) vengono scritti in stderr. Non scrivere script con le risposte scritte a stderr perché queste risposte non sono stabili.

Per le linee guida sulla gestione dell'output, consulta la Guida agli script.

Richiesta

Per evitare azioni dannose e indesiderate, l'interfaccia a riga di comando gcloud conferma le intenzioni prima di eseguire comandi come gcloud projects delete.

Potresti ricevere una richiesta quando sono necessarie ulteriori informazioni. 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 la richiesta, utilizza l'opzione --quiet.

Non scrivere nel testo delle richieste, perché potrebbe cambiare.

Soppressione della richiesta, della scrittura nel terminale e del logging

L'opzione --quiet (anche -q) per l'interfaccia a riga di comando gcloud disabilita tutte le richieste interattive durante l'esecuzione dei comandi dell'interfaccia a riga di comando gcloud ed è utile per lo script. Se sono necessari input, vengono utilizzati i valori predefiniti. Se non è presente un'impostazione predefinita, viene generato un errore.

Per impedire la stampa dell'output comando su output standard ed 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, avvisi, errore, critico o nessuno) utilizzando l'opzione --verbosity.

Determinazione della struttura di output

Per impostazione predefinita, quando un comando dell'interfaccia a riga di comando gcloud restituisce un elenco di risorse, queste vengono stampate in modo casuale sull'output standard. Per produrre un output più significativo, le opzioni format, filter e projection consentono di perfezionare il risultato.

Per definire solo il formato dell'output, utilizza l'opzione --format per produrre una versione tabulata o appiattita dell'output (per la visualizzazione interattiva) o una versione leggibile dal computer dell'output (json, csv, yaml, value).

Per formattare un elenco di chiavi che selezionano valori dei dati delle risorse, utilizza projections. Per perfezionare ulteriormente l'output in base ai criteri definiti, utilizza filter.

Per acquisire familiarità con le funzionalità di filtro e formattazione, puoi completare un breve tutorial interattivo facendo clic su Apri in Cloud Shell.

Apri in Cloud Shell

Passaggi successivi