Un elenco di comandi di riferimento per Google Cloud CLI, lo strumento principale a riga di comando di Google Cloud.
(sono inclusi anche: video introduttivo, comandi di comprensione e un PDF stampabile.)
Scheda di riferimento
Per iniziare
Inizia a utilizzare l'interfaccia a riga di comando gcloud.
gcloud init
: inizializza, autorizza e configura l'interfaccia a riga di comando gcloud.gcloud version
: versione display e componenti installati.gcloud components install
: installa i componenti specifici.gcloud components update
: aggiorna l'interfaccia a riga di comando gcloud alla versione più recente.gcloud config set project
: imposta un progetto Google Cloud predefinito su cui lavorare.gcloud info
: mostra i dettagli dell'ambiente dell'interfaccia a riga di comando gcloud corrente.
Guida
L'interfaccia a riga di comando gcloud è felice di aiutarti.
gcloud help
: cerca i termini di riferimento dell'interfaccia a riga di comando gcloud.gcloud feedback
: invia un feedback al team dell'interfaccia a riga di comando gcloud.gcloud topic
: materiale di assistenza aggiuntivo per argomenti non di comando come accessibilità, filtri e formattazione.
Personalizzazione
Personalizza l'interfaccia a riga di comando gcloud: personalizza la configurazione con le proprietà.
gcloud config set
: definisci una proprietà (come compute/zone) per la configurazione attuale.gcloud config get
: recupera il valore di una proprietà dell'interfaccia a riga di comando gcloud.gcloud config list
: mostra tutte le proprietà per la configurazione corrente.gcloud config configurations create
: crea una nuova configurazione denominata.gcloud config configurations list
: mostra un elenco di tutte le configurazioni disponibili.gcloud config configurations activate
: passa a una configurazione con nome esistente.
Autorizzazione e credenziali
Concedi e revoca l'autorizzazione per l'interfaccia a riga di comando gcloud e gestisci le credenziali.
gcloud auth login
: autorizza l'accesso a Google Cloud per gcloud CLI con le credenziali utente Google Cloud e imposta l'account attuale come attivo.gcloud auth activate-service-account
: autorizza l'accesso a Google Cloud simile agcloud auth login
, ma con le credenziali dell'account di servizio.gcloud auth application-default
: gestisci le tue 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
: mostra il token di accesso dell'account attuale.gcloud auth revoke
: per rimuovere un account con credenziali di accesso.
Progetti
Gestisci i criteri di accesso al progetto.
gcloud projects describe
: consente di visualizzare i metadati di un progetto (incluso l'ID corrispondente).gcloud projects add-iam-policy-binding
: aggiungi un'associazione dei criteri IAM a un progetto specificato.
IAM
Configurare le preferenze e gli account di servizio di Identity and Access Management (IAM).
gcloud iam list-grantable-roles
: elenca i ruoli assegnabili IAM 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 dei criteri IAM a un account di servizio.gcloud iam service-accounts set-iam-policy-binding
: sostituisci l'associazione esistente dei criteri IAM.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 l'interfaccia a riga di comando gcloud come assistente di credenziali Docker.gcloud container clusters create
: crea un cluster per eseguire i container GKE.gcloud container clusters list
: elenco dei cluster per l'esecuzione dei container GKE.gcloud container clusters get-credentials
: aggiornakubeconfig
per ottenerekubectl
da utilizzare un cluster GKE.gcloud container images list-tags
: elenca i metadati di tag e digest per un'immagine container.
Macchine virtuali e Compute Engine
Crea, esegui e gestisci VM nell'infrastruttura di Google Cloud.
gcloud compute zones list
: elenca le zone di Compute Engine.gcloud compute instances create
: crea un'istanza VM.gcloud compute instances describe
: mostra 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 di dischi permanenti.gcloud compute snapshots describe
: consente di visualizzare i dettagli di uno snapshot.gcloud compute snapshots delete
: Elimina uno snapshot.gcloud compute ssh
: connettiti a un'istanza VM utilizzando 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 nel server App Engine.gcloud app browse
: apri l'app corrente in un browser web.gcloud app create
: crea un'app App Engine nel progetto attuale.gcloud app logs read
: visualizza i log dell'app App Engine più recenti.
Vari
Comandi che potrebbero tornare utili
gcloud kms decrypt
: decripta il testo di crittografia (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
: Mostra le informazioni sul backup di un'istanza Cloud SQL.gcloud sql export sql
: esporta i dati da un'istanza Cloud SQL in un file SQL.
Primer introduttivo
Un rapido primer per iniziare a utilizzare l'interfaccia a riga di comando gcloud.
Installazione di Google Cloud CLI
Installa Google Cloud CLI con queste istruzioni di installazione.
Bandiere, argomentazioni e altre aggiunte meravigliose
Gli argomenti possono essere argomenti posizionali o flag:
- argomenti posizionali: impostati dopo il nome del comando; devono rispettare l'ordine degli argomenti posizionali.
Flag:impostale dopo gli argomenti di posizione; l'ordine delle segnalazioni non è importante.
Un flag può essere:
- Coppia nome-valore (
--foo=bar
) oppure - 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 (
Bandiere globali
Alcuni flag sono disponibili durante l'intera esperienza dell'interfaccia a riga di comando gcloud, come:
--help
: per informazioni dettagliate, visualizza la guida dettagliata per un comando.--project
: se utilizzi un progetto diverso da quello attuale.--quiet
: disattivazione della richiesta interattiva (e applicazione dei valori predefiniti per gli input).--verbosity
: Puoi impostare livelli di dettaglio adebug
,info
,warning
,error
,critical
enone
.--version
: mostra le informazioni sulla versione digcloud
.--format
: imposta il formato di output comeconfig
,csv
,default
,diff
,disable
,flattened
,get
,json
,list
,multi
,none
,object
,table
,text
,value
oyaml
.
Pulizia dei risultati
Sfrutta al meglio l'output con i flag filter, format, limit e order.
Per le istanze di Compute Engine con prefisso us
e non tipo di macchinaf1-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 in base alla meno recente, come tabella con numero di progetto, ID progetto e colonne data/ora di creazione con date e orari 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 di Compute Engine con etichetta my-label
(di qualsiasi valore):
gcloud compute instances list --filter="labels.my-label:*" --limit=10
Informazioni sui comandi
Pattern sottostanti per i comandi dell'interfaccia a riga di comando gcloud; per facilitare l'individuazione autonoma dei comandi.
Ricerca dei comandi dell'interfaccia a riga di comando gcloud
L'interfaccia a riga di comando gcloud è una struttura ad albero; i nodi non foglia sono gruppi di comandi e i nodi foglia sono comandi. Inoltre, il completamento delle schede funziona per i comandi e le risorse.
La maggior parte dei comandi gcloud
ha 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 indica lo stato della release del comando.
Esempio:alpha
per i comandi alpha e beta
per i comandi beta; non è necessario alcun livello di rilascio 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à indica la forma plurale di un elemento o una raccolta di elementi di un componente.
Esempio: disks
, firewalls
, images
, instances
, regions
, zones
per il calcolo
Operazione
Operazione si riferisce alla forma verbi imperativa dell'operazione da eseguire sull'entità.
Esempio: 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 necessari specifici dell'ordine necessari per eseguire il comando.
Esempio: <INSTANCE_NAMES>
è l'argomento posizionale richiesto per gcloud compute instances create
.
Flag
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 flag facoltativi per gcloud compute instances create
.