Questa pagina contiene una panoramica di Google Cloud CLI e dei suoi pattern e funzionalità di comando comuni.
Che cos'è l'gcloud CLI?
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 della piattaforma tramite la riga di comando oppure tramite script e altre funzionalità di automazione.
Ad esempio, puoi utilizzare lgcloud 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 di Dataproc
- Zone e set di record gestiti di Cloud DNS
- Deployment di Cloud Deployment Manager
Puoi anche utilizzare l'gcloud CLI per eseguire il deployment di applicazioni App Engine, gestire l'autenticazione, personalizzare la configurazione locale ed eseguire altre attività.
La scheda di riferimento dell'interfaccia a riga di comando gcloud
Per una rapida introduzione gcloud CLI, un elenco di comandi di uso comune e per dare un'occhiata alla struttura di questi comandi, 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'gcloud CLI è disponibile automaticamente e non è necessario installarla. In caso contrario, scarica e installa l'interfaccia a riga di comando gcloud, quindi inizializzala.
Per impostazione predefinita, l'gcloud CLI installa i comandi che sono a livello di disponibilità generale. Sono disponibili funzionalità aggiuntive nei componenti dell'interfaccia a riga della gcloud CLI: alpha e beta. Questi componenti consentono di utilizzare gcloud CLI per lavorare con Cloud Bigtable, Dataflow e altre parti di Google Cloud a livelli di rilascio precedenti rispetto alla disponibilità generale.
L'attuale interfaccia alla gcloud CLI è 432.0.0. Puoi scaricare e installare le versioni precedenti dell'interfaccia alla gcloud CLI dall'archivio di download.
Livelli di release
I comandi dellgcloud CLI 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 preavviso per le modifiche ai comandi che danneggiano la funzionalità corrente, consulta le note di rilascio. |
| Beta | beta |
I comandi sono completi dal punto di vista funzionale, ma potrebbero comunque presentare alcuni problemi in sospeso. È possibile apportare modifiche a questi comandi senza preavviso. |
| Alpha | alpha |
I comandi sono disponibili in anteprima e potrebbero cambiare senza preavviso. |
I componenti alpha e beta non sono installati per impostazione predefinita quando si installa 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, l'interfaccia alla gcloud CLI ti chiede di installarlo.
Gruppi di comandi
All'interno di ogni livello di rilascio, i comandi dell'interfaccia alla gcloud CLI sono organizzati in una gerarchia nidificata di gruppi di comandi, ciascuno 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 nella disponibilità generale |
gcloud compute instances |
Comandi relativi alle istanze Compute Engine nella disponibilità generale |
gcloud beta compute |
Comandi relativi a Compute Engine in 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 della gcloud CLI 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 gcloud CLI. Alcune di queste proprietà possono essere impostate da opzioni globali o tramite comando; in tal caso, il valore impostato dall'opzione ha la precedenza.
Attivazione delle funzioni di accessibilità in corso...
Per un'esperienza più intuitiva per lo screen reader, l'gcloud CLI viene fornita con una proprietà accessibility/screen_reader.
Per attivare la proprietà di accessibilità, esegui:
gcloud config set accessibility/screen_reader true
Per ulteriori 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à gcloud CLI. Una configurazione funziona come un profilo.
Quando inizi a utilizzare l'interfaccia alla gcloud CLI, lavori con una singola configurazione 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 impostare più configurazioni con gcloud config configurations create e cambiare tra le configurazioni. 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 un account dettagliato di questi concetti, consulta la guida alle configurazioni.
Opzioni globali
Gcloud CLI 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à gcloud CLI.
Argomenti e opzioni di posizionamento
Anche se gli argomenti e le opzioni di posizionamento influiscono sull'output di un comando gcloud CLI, c'è una leggera differenza nei loro casi d'uso. Un argomento posizionale viene utilizzato per definire un'entità su cui opera un comando mentre è richiesta un'opzione per impostare una variante nel comportamento di un comando.
Utilizzo di stdout e stderr
L'output dei comandi dell'interfaccia a riga di comando gcloud CLI riusciti è scritto in stdout. Tutti gli altri tipi di risposte (messaggi, avvisi ed errori) vengono
scritti in stderr. Non creare script per 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 proteggerti da azioni dannose e distruttive, l'gcloud CLI conferma le tue intenzioni prima di eseguire comandi come gcloud projects delete.
È possibile che ti venga richiesto 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 sulla base delle formulazioni dei messaggi perché potrebbero cambiare.
Eliminazione delle richieste, 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 quando esegue comandi gcloud CLI ed è utile per lo script. Se è necessario inserire dei dati, vengono utilizzati i valori predefiniti. Se non è presente un'impostazione predefinita, viene generato un errore.
Per eliminare la stampa dell'output comando sull'output standard e sull'errore standard nel terminale, utilizza l'opzione --no-user-output-enabled.
Per modificare 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 degli output
Per impostazione predefinita, quando un comando dell'interfaccia a riga della gcloud CLI restituisce un elenco di risorse, queste vengono stampate in modo pratico nell'output standard. Per produrre un output più significativo, le opzioni format, filter e projection consentono di ottimizzare l'output.
Per definire solo il formato dell'output, utilizza l'opzione --format per produrre una versione tabulata o appiattita del tuo output (per la visualizzazione interattiva) o una versione leggibile 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.
Passaggi successivi
- Scopri di più sui comandi dell'interfaccia a riga di comando gcloud CLI nel riferimento dell'interfaccia a riga di comando gcloud.