gcloud compute

Linux Windows

Google Cloud CLI ti consente di gestire le risorse Compute Engine utilizzando il gruppo di comandi gcloud compute. gcloud compute è un'alternativa all'utilizzo dell'API Compute Engine.

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

Nota: stai cercando le pagine di riferimento per i comandi gcloud compute? Prova la funzione --help della riga di comando. Ad esempio, per ricevere assistenza sulla creazione di istanze, utilizza gcloud compute instances create --help. Puoi consultare tutta la documentazione della riga di comando nella documentazione di riferimento di Google Cloud CLI.

Se non hai mai utilizzato Compute Engine, inizia con la guida rapida per Linux o la guida rapida per Windows.

Prima di iniziare

• Se vuoi eseguire gcloud compute in un prompt dei comandi, installa, aggiorna e inizializza Google Cloud CLI.
• Se non hai un prompt dei comandi facilmente disponibile, prova a utilizzare gcloud compute in Cloud Shell. Cloud Shell viene installato, aggiornato e inizializzato automaticamente con l'ultima versione 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 quando configuri e inizializzi Google Cloud CLI, tutti i comandi gcloud compute utilizzano questo ID progetto per impostazione predefinita.

Puoi sostituire l'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 progetto del progetto che vuoi utilizzare come predefinito.

  Annullamento dell'impostazione delle variabili di ambiente del progetto

  Se devi annullare l'impostazione delle variabili di ambiente del progetto, utilizza i seguenti 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 progetto del progetto che vuoi utilizzare come predefinito.

  Annullamento dell'impostazione delle variabili di ambiente del progetto

  Se devi annullare l'impostazione delle variabili di ambiente del progetto, utilizza il seguente comando:

  set CLOUDSDK_CORE_PROJECT=
  

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

Regione e zona predefinite

Alcuni comandi gcloud compute richiedono i 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 predefinita ed esegui un comando dipendente 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 di metadati. La regione e la zona predefinite impostate nel server di metadati vengono applicate al client locale quando esegui gcloud init.
• Nel client locale. La regione e la zona predefinite impostate nel client locale sostituiscono la regione e la zona predefinite impostate nel server di metadati.
• Nelle variabili di ambiente. La regione e la zona predefinite impostate nelle variabili di ambiente sostituiscono la regione e la zona predefinite impostate nel client locale e nel server di metadati.

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

Visualizzare la regione e la zona predefinite

Per visualizzare la regione e la zona predefinite, esegui i seguenti comandi:

gcloud config get-value compute/region

gcloud config get-value compute/zone

Se l'output è (unset), non è stata impostata alcuna regione o zona predefinita.

Visualizzare le regioni e le zone disponibili

Puoi visualizzare un elenco di regioni e zone eseguendo i seguenti comandi:

gcloud compute regions list

gcloud compute zones list

Impostare la regione e la zona predefinite nel server di metadati

La regione e la zona predefinite nel server di metadati si applicano a tutte le configurazioni del progetto. Per impostare la regione e la zona predefinite nel server di 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 client locale:

   gcloud init

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

Nota: non esistono restrizioni sulla zona o sulle regioni che puoi impostare per le proprietà predefinite. Ad esempio, è possibile impostare una zona predefinita al di fuori della regione predefinita.

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

Per annullare l'impostazione della regione e della zona predefinite nel server di 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 client locale:

   gcloud init

Impostare la regione e la zona predefinite nel client locale

La regione e la zona predefinite impostate nel client locale sostituiscono la regione e la zona predefinite impostate nel server di 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

Annullare 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 i seguenti comandi:

gcloud config unset compute/zone

gcloud config unset compute/region

Puoi sostituire 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 la regione e la zona predefinite impostate nel client locale e nel server di metadati.

Linux e macOS

Utilizza il comando export per impostare le variabili di 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 di regione e zona.

set CLOUDSDK_COMPUTE_REGION=REGION

set CLOUDSDK_COMPUTE_ZONE=ZONE

Puoi sostituire le variabili di ambiente includendo il flag --zone o --region nei comandi.

Annullare l'impostazione della regione e della zona predefinite nelle variabili di ambiente

Utilizza i seguenti comandi 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 di regione e zona, utilizza i seguenti comandi unset:

unset CLOUDSDK_COMPUTE_REGION

unset CLOUDSDK_COMPUTE_ZONE

Windows

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

set CLOUDSDK_COMPUTE_REGION=

set CLOUDSDK_COMPUTE_ZONE=

Sostituire la zona predefinita con i flag

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

Ad esempio:

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

Configurazioni

gcloud topic configurations è una funzionalità avanzata che puoi utilizzare per influenzare il comportamento di gcloud CLI. Per la maggior parte degli utenti, l'utilizzo delle configurazioni predefinite è sufficiente.

Le configurazioni potrebbero essere utili per gli utenti che:

• Lavorano con più progetti. Puoi creare una configurazione separata per ogni progetto.
• Utilizzano più account. Ad esempio, un account utente e un account di servizio.
• Eseguono una serie di attività indipendenti (lavorano su un'app App Engine in un progetto, amministrano un cluster Compute Engine nella zona us-central-1a, gestiscono le configurazioni di rete per la regione asia-east-1 e così via).

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

gcloud config configurations activate CONFIGURATION_NAME

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

Passaggi successivi

• Segui la guida rapida per Google Cloud CLI.
• Consulta i suggerimenti sull'utilizzo di gcloud compute .
• Scopri i comandi comuni gcloud compute.