gcloud compute

Google Cloud CLI ti consente di gestire le risorse Compute Engine, utilizzando Gruppo di comandi gcloud compute. gcloud compute è un'alternativa all'utilizzo del metodo l'API Compute Engine.

L'interfaccia a riga di comando gcloud fa parte di Google Cloud CLI ed è uno strumento a riga di comando unificato che include funzionalità come la compilazione automatica delle istruzioni, l'aggiornamento in situ, la guida a riga di comando, i formati di output leggibili e analizzabili dalla macchina e l'integrazione con Google Cloud CLI.

Se non hai mai utilizzato Compute Engine, inizia con uno dei due Guida rapida di Linux oppure la guida rapida di Windows.

Prima di iniziare

  • Se vuoi eseguire gcloud compute in un prompt dei comandi, install, aggiornare e inizializzare Google Cloud CLI.
  • Se non hai un prompt dei comandi subito disponibile, prova a utilizzare gcloud compute pollici Cloud Shell. Cloud Shell viene installato, aggiornato e inizializzato automaticamente con la versione più recente di Google Cloud CLI.

Proprietà predefinite

Quando crei un'istanza di macchina virtuale, Compute Engine configura una VM utilizzando le proprietà predefinite del server di metadati. Puoi controllare le proprietà predefinite della VM eseguendo il seguente comando:

gcloud compute project-info describe --project PROJECT_ID

Sostituisci PROJECT_ID con l'ID progetto.

Progetto predefinito

Se imposti un progetto predefinito durante la configurazione e l'inizializzazione di Google Cloud CLI, tutti i comandi gcloud compute utilizzano per impostazione predefinita l'ID progetto.

Puoi eseguire l'override dell'ID progetto predefinito utilizzando uno dei seguenti metodi:

  • Esegui ogni comando gcloud compute con il flag --project

  • Imposta la variabile di ambiente CLOUDSDK_CORE_PROJECT

    Linux e macOS

    Utilizza il comando export per impostare la variabile di ambiente del progetto.

    export CLOUDSDK_CORE_PROJECT=PROJECT_ID

    Sostituisci PROJECT_ID con l'ID del progetto che vuoi usare come impostazione predefinita.

    Reimpostazione delle variabili di ambiente del progetto

    Se devi annullare l'impostazione delle variabili di ambiente del progetto, usa quanto segue Comandi unset:

    unset CLOUDSDK_CORE_PROJECT

    Windows

    Utilizza il comando set per impostare la variabile di ambiente del progetto.

    set CLOUDSDK_CORE_PROJECT=PROJECT_ID

    Sostituisci PROJECT_ID con l'ID del progetto che vuoi usare come impostazione predefinita.

    Reimpostazione delle variabili di ambiente del progetto

    Se devi annullare l'impostazione delle variabili di ambiente del progetto, usa quanto segue :

    set CLOUDSDK_CORE_PROJECT=

Se non imposti una variabile di progetto o di ambiente predefinita, devi includere un --project flag in ogni comando gcloud compute eseguito.

Regione e zona predefinite

Alcuni comandi gcloud compute richiedono flag --region o --zone. Anziché specificare questi flag ogni volta che esegui i comandi, puoi impostare una regione e una zona predefinite per il tuo progetto. Se non imposti una regione o una zona predefinite ed esegui un comando che dipende dalla regione o dalla zona, Google Cloud CLI potrebbe chiederti di fornire un flag --region o --zone oppure restituire un errore.

Puoi impostare la regione e la zona predefinite in tre modi:

  • Nel server dei metadati: La regione e la zona predefinite impostate nel server dei metadati vengono applicate al tuo client locale quando esegui gcloud init.
  • Nel tuo client locale. La regione e la zona predefinite impostate nel client locale sostituiscono quelle predefinite impostate nel server dei metadati.
  • Nelle variabili di ambiente. La regione e la zona predefinite impostate nelle variabili di ambiente sostituiscono quelle predefinite regione e zona impostate nel client locale e nel server dei metadati.

Puoi sostituire la regione e la zona predefinite nel server dei metadati, nel client locale o nelle variabili di ambiente, fornendo i flag --region e --zone quando esegui i comandi.

Visualizzare la regione e la zona predefinite

Per visualizzare la regione e la zona predefinite, esegui questo comando :

gcloud config get-value compute/region
 
gcloud config get-value compute/zone

Se l'output è (unset), non vengono impostate regioni o zone predefinite.

Visualizza le regioni e le zone disponibili

Per visualizzare un elenco di regioni e zone, esegui i seguenti comandi:

gcloud compute regions list
 
gcloud compute zones list

Imposta regione e zona predefinite nel server dei metadati

La regione e la zona predefinite nel server dei metadati si applicano a tutti configurazioni nel tuo progetto. Per impostare la regione e la zona predefinite nel server dei metadati:

  1. Imposta la regione e la zona predefinite:

    gcloud compute project-info add-metadata \
   --metadata google-compute-default-region=REGION,google-compute-default-zone=ZONE

    Ad esempio:

    gcloud compute project-info add-metadata \
   --metadata google-compute-default-region=europe-west1,google-compute-default-zone=europe-west1-b

  2. Inizializza la modifica nel tuo client locale:

    gcloud init

Puoi eseguire l'override della regione e della zona predefinite impostate nel server dei metadati impostare la regione e la zona predefinite nel client locale, impostare i valori predefiniti regione e zona nelle variabili di ambiente oppure includendo i valori --zone o --region nei tuoi comandi.

Annullare l'impostazione della regione e della zona predefinite nel server dei metadati

Per annullare l'impostazione della regione e della zona predefinite nel server dei metadati:

  1. Annulla l'impostazione dei metadati:

    gcloud compute project-info remove-metadata \
   --keys=google-compute-default-region,google-compute-default-zone

  2. Inizializza la modifica nel tuo client locale:

    gcloud init

Imposta regione e zona predefinite nel client locale

La regione e la zona predefinite impostate nel client locale sostituiscono quelle predefinite regione e zona impostate nel server dei metadati.

Per impostare la regione e la zona predefinite nel client locale, esegui i seguenti comandi:

gcloud config set compute/region REGION

gcloud config set compute/zone ZONE

Annulla l'impostazione della regione e della zona predefinite nel client locale

Per annullare l'impostazione della regione o della zona predefinita nel client locale, esegui questo comando :

gcloud config unset compute/zone

gcloud config unset compute/region

Puoi ignorare la regione e la zona predefinite impostate nel client locale impostando la regione e la zona predefinite nelle variabili di ambiente o includendo il flag --zone o --region nei comandi.

Impostare la regione e la zona predefinite nelle variabili di ambiente

La regione e la zona predefinite impostate nelle variabili di ambiente sostituiscono quelle predefinite regione e zona impostate nel client locale e nel server dei metadati.

Linux e macOS

Utilizza il comando export per impostare le variabili regione e zona.

export CLOUDSDK_COMPUTE_REGION=REGION

export CLOUDSDK_COMPUTE_ZONE=ZONE

Per rendere permanenti queste variabili di ambiente, includi questi comandi nel file ~/.bashrc e riavvia il terminale.

Windows

Utilizza il comando set per impostare le variabili regione e zona.

set CLOUDSDK_COMPUTE_REGION=REGION

set CLOUDSDK_COMPUTE_ZONE=ZONE

Puoi eseguire l'override delle variabili di ambiente includendo --zone o --region nei tuoi comandi.

Reimposta la regione e la zona predefinite nelle variabili di ambiente

Utilizza i comandi seguenti per annullare l'impostazione della regione e della zona predefinite nelle variabili di ambiente.

Linux e macOS

Per annullare l'impostazione delle variabili di ambiente per regione e zona, utilizza quanto segue Comandi unset:

unset CLOUDSDK_COMPUTE_REGION

unset CLOUDSDK_COMPUTE_ZONE

Windows

Per annullare l'impostazione delle variabili di ambiente della regione e della zona, utilizza i seguenti comandi:

set CLOUDSDK_COMPUTE_REGION=

set CLOUDSDK_COMPUTE_ZONE=

Override zona predefinita con flag

Utilizza il flag --zone per sostituire la zona predefinita impostata nel server dei metadati, nel client locale e nelle variabili di ambiente.

Ad esempio:

gcloud compute instances create example-instance \
    --zone=ZONE

Configurazioni

gcloud topic configurations sono una funzione avanzata che puoi usare per influenzare il comportamento con gcloud CLI. Per la maggior parte degli utenti, l'utilizzo delle configurazioni predefinite è sufficiente.

Le configurazioni potrebbero essere utili per gli utenti che:

  • Lavorare con più progetti. Puoi creare una configurazione separata per ogni progetto.
  • Utilizza più account. Ad esempio, un account utente e un account di servizio.
  • Esegui una serie di attività indipendenti (lavora su un'app App Engine in un progetto, amministra un cluster Compute Engine nella zona us-central-1a, gestisci le configurazioni di rete per la regione Asia-East-1 e così via).

Per passare da una configurazione all'altra, esegui questo comando:

gcloud config configurations activate CONFIGURATION_NAME

Per ulteriori informazioni sulla gestione delle configurazioni, consulta gcloud config configurations

Passaggi successivi