Questa pagina contiene una panoramica di Google Cloud CLI e delle sue funzionalità e dei suoi pattern di comando comuni.
Che cos'è l'interfaccia a riga di comando gcloud?
Google Cloud CLI è un insieme di strumenti per creare e gestire le risorseGoogle Cloud . 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 l'interfaccia a riga di comando gcloud 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 l'interfaccia a riga di comando gcloud
La versione corrente di gcloud CLI è 511.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. Funzionalità aggiuntive sono disponibili nei componenti dell'interfaccia a riga di comando gcloud 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 del 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 l'uso in produzione. Per 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 essere ancora presenti alcuni problemi. Le modifiche che comportano una rottura di questi comandi possono essere apportate senza preavviso. |
| Alpha | alpha |
I comandi sono in versione beta 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 release, i comandi della CLI gcloud sono organizzati in una gerarchia nidificata di gruppi di comandi, ciascuno 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 disponibili a livello generale |
gcloud compute instances |
Comandi relativi alle istanze Compute Engine disponibili a livello 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 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à 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 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, la CLI 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. Una configurazione funziona come un profilo.
Quando inizi a utilizzare l'interfaccia a riga di comando gcloud, lavorerai con una singola configurazione denominata default e potrai 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 passare da una all'altra. All'interno di una configurazione, puoi personalizzare le proprietà.
Ad esempio, per impostare il progetto in una configurazione attiva, utilizza la proprietà project:
gcloud config set project <project-id>
Per una descrizione dettagliata 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.
Argomenti posizionali e opzioni
Sebbene gli argomenti posizionali e le opzioni influiscano sull'output di un comando della CLI gcloud, esiste una sottile differenza nei 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 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 creare script in base alle risposte scritte in stderr perché
queste risposte non sono stabili.
Per le linee guida sulla gestione dell'output, consulta la guida agli script.
Prompting
Per proteggerti da azioni dannose indesiderate, l'interfaccia a riga di comando gcloud conferma le tue intenzioni prima di eseguire comandi comegcloud 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 script in base alla formulazione dei prompt perché può cambiare.
Omissione di richieste, scrittura nel terminale e registrazione
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 non è presente 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 il livello di dettaglio dei log, specifica un livello di dettaglio (debug, info, warning,
error, critical o none) utilizzando l'opzione
--verbosity.
Determinazione della struttura di output
Per impostazione predefinita, quando un comando gcloud CLI restituisce un elenco di risorse, queste vengono stampate in un formato gradevole nell'output standard. Per produrre un output più significativo, le opzioni format, filter e projection ti consentono di perfezionarlo.
Per definire solo il formato dell'output, utilizza l'opzione --format per produrre una versione tabellata 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 della risorsa, utilizza
projections. Per perfezionare ulteriormente il risultato in base ai criteri che definisci, utilizza filter.
Passaggi successivi
- Scopri di più sui comandi gcloud CLI nel riferimento di gcloud CLI.