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.
gcloud CLI fa parte di Google Cloud CLI ed è un servizio a strumento a riga di comando che include funzioni come il completamento automatico delle istruzioni, aggiornamento in loco, guida a riga di comando, testo leggibile formati di output analizzabili dalle macchine e 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 l'interfaccia a riga di comando più recente di Google Cloud CLI.
Proprietà predefinite
Quando crei un'istanza di una macchina virtuale, Compute Engine configura una VM utilizzando le proprietà predefinite server metadati. Puoi per controllare le proprietà predefinite della tua VM eseguendo questo 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 questo ID progetto per impostazione predefinita.
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.Annullamento 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.Annullamento 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 una
--project
in ogni comando gcloud compute
che esegui.
Regione e zona predefinite
Alcuni comandi gcloud compute
richiedono flag --region
o --zone
.
Anziché specificare questi flag ogni volta che esegui dei comandi, puoi impostare
la regione e la zona predefinite
per il tuo progetto. Se non imposti una regione predefinita o
ed esegui un comando che dipende dalla regione o dalla zona, Google Cloud CLI potrebbe
ti chiede di fornire un flag --region
o --zone
oppure restituisce 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 eseguono l'override di quelle predefinite regione e zona 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 eseguire l'override della regione e della zona predefinite nel
server di metadati, nel tuo client locale o nelle variabili di ambiente,
Flag --region
e --zone
quando esegui i comandi.
Visualizza regione e 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
Puoi visualizzare un elenco di regioni e zone eseguendo questi 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 predefinita e nel server dei metadati, segui questi passaggi:
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
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.
Annulla 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:
Annulla l'impostazione dei metadati:
gcloud compute project-info remove-metadata \ --keys=google-compute-default-region,google-compute-default-zone
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 eseguono l'override di quelle predefinite regione e zona impostate nel server dei metadati.
Per impostare la regione e la zona predefinite nel client locale, esegui questo comando :
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 eseguire l'override della regione e della zona predefinite impostate nel client locale impostando
la regione e la zona predefinite nelle variabili di ambiente o includendo
--zone
o --region
nei tuoi comandi.
Imposta regione e 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 per regione e zona.
export CLOUDSDK_COMPUTE_REGION=REGION
export CLOUDSDK_COMPUTE_ZONE=ZONE
Per rendere permanenti queste variabili di ambiente, includi questi comandi in
il file ~/.bashrc
e riavvia il terminale.
Windows
Utilizza il comando set
per impostare le variabili per 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.
Annulla l'impostazione della regione e della zona predefinite nelle variabili di ambiente
Utilizza i comandi seguenti per annullare l'impostazione della regione e della zona predefinite nell'ambiente come la codifica one-hot delle variabili categoriche.
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 per regione e zona, utilizza quanto segue :
set CLOUDSDK_COMPUTE_REGION=
set CLOUDSDK_COMPUTE_ZONE=
Override zona predefinita con flag
Utilizza il flag --zone
per eseguire l'override della zona predefinita
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
sufficienti.
Le configurazioni potrebbero essere utili per gli utenti che:
- Lavora con più progetti. Puoi creare una configurazione separata per ogni progetto.
- Utilizza più account. Ad esempio, un account utente e un account di servizio.
- Eseguire una serie di attività indipendenti (lavorare su un'app di App Engine in amministrare 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
- Segui la guida rapida per Google Cloud CLI.
- Consulta
gcloud compute
suggerimenti per l'utilizzo. - Da scoprire
comandi
gcloud compute
comuni.