Un elenco di comandi go-to per Google Cloud CLI, il principale strumento a riga di comando per Google Cloud.
Sono inclusi anche: introduzione, comandi di comprensione e un PDF stampabile.
Scheda di riferimento
Per iniziare
Inizia con gcloud CLI.
gcloud init
: inizializza, autorizza e configura gcloud CLI.gcloud version
: mostra la versione e i componenti installati.gcloud components install
: installa componenti specifici.gcloud components update
: aggiorna gcloud CLI alla versione più recente.gcloud config set project
: imposta un progetto Google Cloud predefinito su cui lavorare.gcloud info
: visualizza i dettagli attuali dell'ambiente gcloud CLI.
Guida
Gcloud CLI è felice di aiutarti.
gcloud help
: cerca termini specifici nei documenti di riferimento dell'interfaccia a riga di comando gcloud.gcloud feedback
: fornisci feedback al team di gcloud CLI.gcloud topic
: materiale di supporto supplementare per argomenti non correlati al comando come accessibilità, filtri e formattazione.
Personalizzazione
Personalizza gcloud CLI; 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à gcloud CLI.gcloud config list
: mostra tutte le proprietà della configurazione attuale.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 con nome esistente.
Autorizzazione e credenziali
Concedi e revoca l'autorizzazione per 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 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 corrente.gcloud auth revoke
: rimuovi le credenziali di accesso per un account.
Progetti
Gestire i criteri di accesso al progetto.
gcloud projects describe
: vengono visualizzati i metadati di un progetto (incluso il relativo ID).gcloud projects add-iam-policy-binding
: aggiungi un'associazione di criteri IAM a un progetto specificato.
IAM
Configurazione delle preferenze di Identity and Access Management (IAM) e degli account di servizio in corso.
gcloud iam list-grantable-roles
: Elenca i ruoli IAM assegnabili 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 di criteri 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 gcloud CLI come helper per le credenziali Docker.gcloud container clusters create
: crea un cluster per eseguire i container GKE.gcloud container clusters list
: Elenca i cluster per l'esecuzione di container GKE.gcloud container clusters get-credentials
: aggiornakubeconfig
per ottenerekubectl
per 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 le VM nell'infrastruttura 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 dei dischi permanenti.gcloud compute snapshots describe
: vengono visualizzati 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 della tua 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 all'interno del 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 crittografato (in un file di testo non crittografato) utilizzando una chiave Cloud Key Management Service.gcloud logging logs list
: elenca i log del progetto.gcloud sql backups describe
: visualizza le informazioni sul backup di un'istanza Cloud SQL.gcloud sql export sql
: esporta i dati da un'istanza Cloud SQL a un file SQL.
Primer introduttivo
Una guida rapida per iniziare a utilizzare gcloud CLI.
Installazione di Google Cloud CLI
Installa Google Cloud CLI seguendo queste istruzioni di installazione.
Flag, argomenti e altre meravigliose aggiunte
Gli argomenti possono essere argomenti o flag posizionali:
- Argomenti di posizionamento: vengono impostati dopo il nome del comando; devono rispettare l'ordine degli argomenti posizionali.
Flag:impostati dopo gli argomenti di posizionamento; l'ordine dei flag non è importante.
Un flag può essere:
- Coppia nome-valore (
--foo=bar
) o - 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'esperienza gcloud CLI, come:
--help
: in caso di dubbi; mostra la guida dettagliata per un comando.--project
: se utilizzi un progetto diverso da quello attuale.--quiet
: disattivazione dei prompt interattivi (e applicazione di valori predefiniti per gli input).--verbosity
: puoi 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 filtro, formato, limite e ordinamento per.
Per le istanze di Compute Engine con prefisso us
e non il 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 meno recente al più recente, presentato in una tabella con le colonne relative a numero di progetto, ID progetto e data 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 facilitare l'individuazione automatica dei comandi.
Trovare i comandi dell'interfaccia a riga di comando gcloud
Gcloud CLI è un albero; i nodi non foglia sono gruppi di comandi, mentre i nodi foglia sono comandi. (Inoltre, il completamento delle schede funziona per comandi e risorse).
La maggior parte dei comandi di 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 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 fa riferimento ai diversi servizi Google Cloud.
Esempio: compute
per Compute Engine, app
per App Engine ecc.
Entità
Entità fa riferimento alla forma plurale di un elemento o di una raccolta di elementi in un componente.
Esempio: disks
, firewalls
, images
, instances
, regions
, zones
per computing
Operazione
L'operazione si riferisce al verbo imperativo 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 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)
, trasmessi al comando dopo gli argomenti posizionali.
Esempio: --machine-type=<MACHINE_TYPE>
e --preemptible
sono flag facoltativi per gcloud compute instances create
.