Un elenco di comandi di uso frequente per Google Cloud CLI, lo strumento a riga di comando principale per Google Cloud.
Sono inclusi anche un panoramica introduttiva, un articolo su come comprendere i comandi e un PDF stampabile.
Scheda di riferimento
Per iniziare
Inizia a utilizzare l'interfaccia alla gcloud CLI.
gcloud init
: inizializza, autorizza e configura la gcloud CLI.gcloud version
: mostra la versione e i componenti installati.gcloud components install
: installa componenti specifici.gcloud components update
: aggiorna la gcloud CLI alla versione più recente.gcloud config set project
: imposta un progetto Google Cloud predefinito su cui lavorare.gcloud info
: mostra i dettagli dell'ambiente gcloud CLI corrente.
Guida
Gcloud CLI è a tua disposizione.
gcloud help
: cerca termini specifici nei documenti di riferimento della gcloud CLI.gcloud feedback
: fornisci un feedback al team gcloud CLI.gcloud topic
: materiale di guida supplementare per argomenti diversi dai comandi, come accessibilità, filtri e formattazione.
Personalizzazione
Personalizza l'interfaccia a riga di comando gcloud con le proprietà.
gcloud config set
: definisci una proprietà (ad esempio compute/zone) per la configurazione attuale.gcloud config get
: recupera il valore di una proprietà gcloud CLI.gcloud config list
: mostra tutte le proprietà per la configurazione corrente.gcloud config configurations create
: crea una nuova configurazione con nome.gcloud config configurations list
: mostra un elenco di tutte le configurazioni disponibili.gcloud config configurations activate
: passa a una configurazione esistente con nome.
Autorizzazione e credenziali
Concedi e revoca l'autorizzazione all'interfaccia alla gcloud CLI e gestisci le credenziali.
gcloud auth login
: autorizza l'accesso a Google Cloud per gcloud CLI con le credenziali utente di Google Cloud e imposta l'account corrente come attivo.gcloud auth activate-service-account
: autorizza l'accesso a Google Cloud in modo simile agcloud auth login
, ma con le credenziali dell'account di servizio.gcloud auth application-default
: gestisci le Credenziali predefinite dell'applicazione (ADC) per le librerie client di Cloud.gcloud auth list
: elenca tutti gli account con credenziali.gcloud auth print-access-token
: visualizza il token di accesso dell'account corrente.gcloud auth revoke
: rimuovi le credenziali di accesso per un account.
Progetti
Gestire i criteri di accesso ai progetti.
gcloud projects describe
: visualizza i metadati di un progetto (incluso l'ID).gcloud projects add-iam-policy-binding
: aggiungi un'associazione del criterio IAM a un progetto specificato.
IAM
Configurazione delle preferenze e degli account di servizio IAM (Identity and Access Management).
gcloud iam list-grantable-roles
: elenca i ruoli IAM concedibili per una risorsa.gcloud iam roles create
: crea un ruolo personalizzato per un progetto o un'organizzazione.gcloud iam service-accounts create
: crea un account di servizio per un progetto.gcloud iam service-accounts add-iam-policy-binding
: Aggiungi un'associazione di criteri IAM a un account di servizio.gcloud iam service-accounts set-iam-policy-binding
: Sostituisci l'associazione del criterio IAM esistente.gcloud iam service-accounts keys list
: elenca le chiavi di un account di servizio.
Docker e Google Kubernetes Engine (GKE)
Gestisci le applicazioni containerizzate su Kubernetes.
gcloud auth configure-docker
: registra la gcloud CLI come assistente per le credenziali Docker.gcloud container clusters create
: crea un cluster per eseguire i contenitori GKE.gcloud container clusters list
: elenca i cluster per l'esecuzione dei contenitori GKE.gcloud container clusters get-credentials
: aggiornakubeconfig
per consentire akubectl
di utilizzare un cluster GKE.gcloud container images list-tags
: elenca il tag e i metadati digest di un'immagine del contenitore.
Macchine virtuali e Compute Engine
Crea, esegui e gestisci VM sull'infrastruttura Google Cloud.
gcloud compute zones list
: elenca le zone Compute Engine.gcloud compute instances create
: crea un'istanza VM.gcloud compute instances describe
: visualizza i dettagli di un'istanza VM.gcloud compute instances list
: elenca tutte le istanze VM in un progetto.gcloud compute disks snapshot
: crea uno snapshot dei dischi permanenti.gcloud compute snapshots describe
: visualizza i dettagli di un'istantanea.gcloud compute snapshots delete
: elimina uno snapshot.gcloud compute ssh
: connettiti a un'istanza VM tramite SSH.
Serverless e App Engine
Crea applicazioni a elevata scalabilità su una piattaforma serverless completamente gestita
gcloud app deploy
: esegui il deployment del codice e della configurazione dell'app sul server App Engine.gcloud app versions list
: elenca tutte le versioni di tutti i servizi di cui è stato eseguito il deployment sul server App Engine.gcloud app browse
: apri l'app corrente in un browser web.gcloud app create
: crea un'app App Engine nel tuo progetto corrente.gcloud app logs read
: mostra gli ultimi log dell'app App Engine.
Vari
Comandi che potrebbero esserti utili
gcloud kms decrypt
: decripta il testo cifrato (in un file di testo normale) utilizzando una chiave di Cloud Key Management Service.gcloud logging logs list
: elenca i log del progetto.gcloud sql backups describe
: visualizza le informazioni su un backup dell'istanza Cloud SQL.gcloud sql export sql
: esporta i dati da un'istanza Cloud SQL in un file SQL.
Guida introduttiva
Una breve introduzione per iniziare a utilizzare gcloud CLI.
Installazione di Google Cloud CLI
Installa Google Cloud CLI seguendo queste istruzioni di installazione.
Flag, argomenti e altre fantastiche aggiunte
Gli argomenti possono essere argomenti posizionali o flag:
- Argomenti posizionali:impostati dopo il nome del comando; devono rispettare l'ordine degli argomenti posizionali.
Flags: impostati dopo gli argomenti posizionali; l'ordine dei flag non è importante.
Un indicatore può essere:
- Coppia nome-valore (
--foo=bar
) oppure - Valore booleano (
--force/no-force
).
Inoltre, i flag possono essere:
- Obbligatorio
- Facoltativo:se non è definito un flag facoltativo, viene utilizzato il valore predefinito
- Coppia nome-valore (
Flag globali
Alcuni flag sono disponibili nell'intera esperienza dell'interfaccia alla gcloud CLI, come:
--help
: in caso di dubbio, visualizza la guida dettagliata di un comando.--project
: se utilizzi un progetto diverso da quello corrente.--quiet
: disattiva la richiesta interattiva (e applica i valori predefiniti per gli input).--verbosity
: può impostare i livelli di dettaglio sudebug
,info
,warning
,error
,critical
enone
.--version
: mostra le informazioni sulla versione digcloud
.--format
: imposta il formato di output suconfig
,csv
,default
,diff
,disable
,flattened
,get
,json
,list
,multi
,none
,object
,table
,text
,value
oyaml
.
Pulizia dei risultati
Ottieni il massimo dall'output con i flag filter, format, limit e sort-by.
Per le istanze Compute Engine con prefisso us
e non con tipo di macchina
f1-micro
:
gcloud compute instances list --filter="zone ~ ^us AND -machineType:f1-micro"
Per un elenco dei progetti creati a partire dal 15 gennaio 2018, ordinati dal più antico al più recente, presentati come una tabella con numero di progetto, ID progetto e colonne di data e ora di creazione con date e ore nel fuso orario locale:
gcloud projects list --format="table(projectNumber,projectId,createTime.date(tz=LOCAL))"
--filter="createTime>=2018-01-15T12:00:00" --sort-by=createTime
Per un elenco di dieci istanze Compute Engine con un'etichetta my-label
(di qualsiasi valore):
gcloud compute instances list --filter="labels.my-label:*" --limit=10
Informazioni sui comandi
I pattern sottostanti per i comandi gcloud CLI; per favorire la scoperta autonoma dei comandi.
Trovare i comandi dell'interfaccia a riga di comando gcloud
Gcloud CLI è un albero; i nodi non foglia sono gruppi di comandi e i nodi foglia sono comandi. Inoltre, il completamento tramite tasto Tab funziona per comandi e risorse.
La maggior parte dei comandi gcloud
segue il seguente formato:
gcloud + release level (optional) + component + entity + operation + positional args + flags
Ad esempio:
gcloud + compute + instances + create + example-instance-1 + --zone=us-central1-a
Livello di release
Livello di rilascio si riferisce allo stato di rilascio del comando.
Esempio: alpha
per i comandi alpha, beta
per i comandi beta, nessun livello di release necessario per i comandi GA.
Componente
Componente si riferisce ai diversi servizi Google Cloud.
Esempio: compute
per Compute Engine, app
per App Engine e così via.
Entità
Entità si riferisce alla forma plurale di un elemento o di una raccolta di elementi in un componente.
Esempio: disks
, firewalls
, images
, instances
, regions
, zones
per l'elaborazione
Operazione
Per Operazione si intende la forma verbale imperativa dell'operazione da eseguire sull'entità.
Esempio: le operazioni comuni sono describe
, list
, create/update
,
delete/clear
, import
, export
, copy
, remove
, add
, reset
, restart
,
restore
, run
e deploy
.
Argomenti posizionali
Gli argomenti posizionali si riferiscono agli argomenti obbligatori specifici per l'ordine necessari per eseguire il comando.
Esempio: <INSTANCE_NAMES>
è l'argomento posizionale obbligatorio per
gcloud compute instances create
.
Bandiere
I flag si riferiscono agli argomenti aggiuntivi, --flag-name(=value)
, passati al comando dopo gli argomenti posizionali.
Esempio: --machine-type=<MACHINE_TYPE>
e --preemptible
sono indicatori facoltativi per gcloud compute instances create
.