Scheda di riferimento dell'interfaccia a riga di comando gcloud

Un elenco di comandi di uso comune 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 a riga di comando gcloud.

• 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 dell'interfaccia a riga di comando gcloud.
• 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 a riga di comando gcloud e gestisci le credenziali.

• gcloud auth login: autorizzaGoogle Cloud l'accesso per l'interfaccia a riga di comando gcloud conGoogle Cloud le credenziali utente e imposta l'account corrente come attivo.
• gcloud auth activate-service-account: autorizza Google Cloud l'accesso simile a gcloud 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: aggiorna kubeconfig per consentire a kubectl di utilizzare un cluster GKE.
• gcloud container images list-tags: elenca i metadati del tag e del digest per un'immagine del contenitore.

Macchine virtuali e Compute Engine

Crea, esegui e gestisci le VM sull' Google Cloud infrastruttura.

• 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.

Varie

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.

Approfondimento introduttivo

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

Flag globali

Alcuni flag sono disponibili nell'intera esperienza dell'interfaccia a riga di comando gcloud, 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 su debug, info, warning, error, critical e none.
• --version: mostra le informazioni sulla versione di gcloud.
• --format: imposta il formato di output su config, csv, default, diff, disable, flattened, get, json, list, multi, none, object, table, text, value o yaml.

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 colonne di numero, ID e data e ora di creazione del progetto 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

L'interfaccia a riga di comando gcloud è 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 Google Cloud servizi.

Esempio: compute per Compute Engine, app per App Engine e così via.

Entità

Per entità si intende la 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 fanno riferimento agli argomenti obbligatori specifici per l'ordine necessari per eseguire il comando.

Esempio: <INSTANCE_NAMES> è l'argomento posizionale obbligatorio 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 indicatori facoltativi per gcloud compute instances create.