Panoramica di gcloud CLI

Questa pagina contiene una panoramica di Google Cloud CLI e delle sue funzionalità e dei suoi pattern di comandi 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 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à.

Scarica e installa gcloud CLI

L'attuale versione di gcloud CLI è 496.0.0.

Sebbene ti consigliamo vivamente di utilizzare la versione corrente dell'interfaccia a riga di comando gcloud, puoi anche scaricare e installare le versioni precedenti dall'archivio dei 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, l'interfaccia a riga di comando gcloud installa i comandi a livello di disponibilità generale. Sono disponibili ulteriori funzionalità disponibili in gcloud CLI componenti denominati alpha e beta. Questi componenti ti consentono di utilizzare l'interfaccia a riga di comando gcloud per lavorare con Bigtable, Dataflow e altre parti di Google Cloud a livelli di release precedenti rispetto alla disponibilità generale.

Scheda di riferimento dell'interfaccia a riga di comando gcloud

Per una breve introduzione all'interfaccia a riga di comando gcloud, un elenco dei comandi di uso comune e un'analisi della loro struttura, consulta la scheda di riferimento dell'interfaccia a riga di comando gcloud.

Livelli di release

I comandi dell'interfaccia a riga di comando gcloud 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 un preavviso delle modifiche ai comandi che interrompono la funzionalità attuale, consulta le 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 comportano una rottura di compatibilità a 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 quando installi gcloud CLI. Devi installare questi componenti usando 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 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 disponibili a livello generale
gcloud compute instances Comandi relativi alle istanze Compute Engine disponibili a livello 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 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 di gcloud sono impostazioni influisce sul comportamento di gcloud CLI i nostri strumenti. Alcune di queste proprietà possono essere impostate tramite opzioni globali o di comando. In questo caso, il valore impostato dall'opzione ha la precedenza.

Attivare le funzioni di accessibilità

Per un'esperienza più semplificata con lo screen reader, 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 ulteriori dettagli sulle funzionalità di accessibilità fornite dallo strumento a riga di comando gcloud, consulta la guida Attivare le funzionalità di accessibilità.

Configurazioni

Una configurazione è un insieme di proprietà dell'interfaccia a riga di comando gcloud. 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 è adatta per la 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. Le opzioni sostituiscono i valori impostati nelle proprietà dell'interfaccia a riga di comando gcloud.

Argomenti e opzioni di posizionamento

Mentre gli argomenti e le opzioni posizionali influiscono sull'output di un gcloud CLI, esiste una sottile differenza nel loro utilizzo 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 dell'interfaccia a riga di comando gcloud andati a buon fine viene scritto in stdout. Tutti gli altri tipi di risposte, prompt, avvisi ed errori, vengono scritti 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 dannose indesiderate, l'interfaccia a riga di comando gcloud conferma le tue intenzioni prima di eseguire comandi comegcloud projects delete.

È possibile che ti vengano chieste 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 la richiesta, 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 l'interfaccia a riga di comando gcloud disattiva tutte le richieste interattive durante l'esecuzione dei comandi dell'interfaccia a riga di comando gcloud ed è utile per la creazione di script. Se sono necessari input, vengono utilizzati i valori predefiniti. Se ci sono non è un valore predefinito, viene generato un errore.

Per impedire la stampa dell'output del comando nell'output standard e nell'errore standard nel terminale, utilizza l'opzione --no-user-output-enabled.

Per regolare la modalità dettagliata dei log, specifica un livello di dettaglio (debug, info, 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 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 il risultato in base ai criteri che definisci, utilizza filter.

Per familiarizzare 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