Questo documento elenca alcuni dei comandi gcloud compute
di uso più comune.
Prima di iniziare
-
Se non l'hai ancora fatto, configura l'autenticazione.
L'autenticazione è il processo mediante il quale viene verificata l'identità per l'accesso ai servizi e alle API Google Cloud.
Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti in Compute Engine nel seguente modo.
-
Installa Google Cloud CLI, quindi initialize eseguendo questo comando:
gcloud init
- Imposta una regione e una zona predefinite.
-
Descrizione dei progetti
Esegui questo comando per eseguire query sulle informazioni relative al tuo progetto Compute Engine, ad esempio metadati del progetto, chiavi SSH e metriche delle quote:
gcloud compute project-info describe
Per ulteriori informazioni sulla descrizione del progetto, consulta la documentazione di riferimento di gcloud compute project-info describe
.
Utilizzo delle VM
I seguenti esempi mostrano le attività comuni quando si lavora con le istanze di macchine virtuali (VM). Per ulteriori informazioni sulle istanze di macchine virtuali (VM), consulta Istanze di macchine virtuali.
Creazione delle VM
Esegui questo comando per creare una VM:
gcloud compute instances create VM_NAME \ [--image IMAGE | --image-family IMAGE_FAMILY] \ --image-project IMAGE_PROJECT
Sostituisci quanto segue:
VM_NAME
: il nome della nuova VM.IMAGE
oIMAGE_FAMILY
: specifica una delle seguenti opzioni:IMAGE
: versione obbligatoria di un'immagine pubblica. Ad esempio,--image debian-10-buster-v20200309
.IMAGE_FAMILY
: una famiglia di immagini. Viene creata la VM dall'immagine del sistema operativo più recente non deprecata. Ad esempio, se specifichi--image-family debian-10
, Compute Engine crea una VM dall'ultima versione dell'immagine sistema operativo nella famiglia di immagini Debian 10.
IMAGE_PROJECT
: il progetto contenente l'immagine.
Per saperne di più sulla creazione delle VM, consulta Creazione e avvio di un'istanza VM e la documentazione di riferimento di gcloud compute instances create
.
Elenco delle VM
Esegui questo comando per visualizzare tutte le VM in un progetto:
gcloud compute instances list
Per ulteriori informazioni sull'elenco delle VM, consulta la documentazione di riferimento di gcloud compute instances list
.
Elenco delle VM con GPU
Esegui questo comando per visualizzare tutte le VM con GPU in un progetto:
gcloud compute instances list --filter="guestAccelerators.acceleratorCount>0" --format="table(name,zone,guestAccelerators.acceleratorType,guestAccelerators.acceleratorCount,disks.type)"
Elenco delle VM con SSD locali
Esegui questo comando per visualizzare tutte le VM con SSD locali in un progetto:
gcloud compute instances list --filter="disks.type='SCRATCH'" --format="table(name,zone,guestAccelerators.acceleratorType,guestAccelerators.acceleratorCount,disks.type)"
Descrizione delle VM
Esegui questo comando per visualizzare tutti i dati associati a una VM:
gcloud compute instances describe VM_NAME
Sostituisci VM_NAME
con il nome della VM.
Per ulteriori informazioni sulla descrizione delle VM, consulta la documentazione di riferimento di gcloud compute instances describe
.
Avvio delle VM
Esegui questo comando per avviare una VM arrestata:
gcloud compute instances start VM_NAME
Sostituisci VM_NAME
con il nome della VM.
Per saperne di più sull'avvio delle VM, consulta Avvio e arresto di un'istanza e la documentazione di riferimento di gcloud compute instances start
.
Arresto delle VM
Esegui questo comando per arrestare una VM:
gcloud compute instances stop VM_NAME
Sostituisci VM_NAME
con il nome della VM.
Per ulteriori informazioni sull'arresto delle VM, consulta Avvio e arresto di un'istanza e la documentazione di riferimento di gcloud compute instances stop
.
Aggiunta di etichette alle VM
Esegui questo comando per aggiungere etichette alle VM:
gcloud compute instances add-labels VM_NAME \ --labels=KEY=VALUE
Sostituisci quanto segue:
VM_NAME
: il nome della VM.KEY=VALUE
: la coppia chiave-valore dell'etichetta.
Per ulteriori informazioni sull'etichettatura delle VM, consulta Risorse per l'etichettatura e documentazione di riferimento di gcloud compute instances add-labels
.
Connessione alle VM
Utilizzo di SSH per connettersi alle istanze
Esegui questo comando per connetterti a una VM tramite SSH:
gcloud compute ssh VM_NAME
Sostituisci VM_NAME
con il nome della VM.
Per ulteriori informazioni sulla connessione alle VM tramite SSH, consulta Connessione alle VM Linux e la documentazione di riferimento di gcloud compute ssh
.
Utilizzo di SCP per il trasferimento di file alle istanze
Esegui questo comando per copiare i file in una VM:
gcloud compute scp LOCAL_FILE_PATH VM_NAME:REMOTE_DIRECTORY
Esegui questo comando per copiare i file da una VM:
gcloud compute scp VM_NAME:REMOTE_DIRECTORY LOCAL_FILE_PATH
Sostituisci quanto segue:
LOCAL_FILE_PATH
: il percorso del file sulla workstation.VM_NAME
: il nome della VM.REMOTE_DIRECTORY
: il percorso della directory sulla VM.
Per saperne di più sul trasferimento di file da e verso le VM utilizzando SCP, consulta Trasferimento di file tramite Google Cloud CLI e la documentazione di riferimento di gcloud compute scp
.
Utilizzo dei dischi
L'esempio seguente mostra un'attività comune quando si utilizzano dischi. Per ulteriori informazioni sui dischi, consulta Opzioni di archiviazione.
Elenco dei dischi
Esegui questo comando per visualizzare tutti i dischi di un progetto:
gcloud compute disks list
Per ulteriori informazioni sull'elenco dei dischi, consulta la documentazione di riferimento di gcloud compute disks list
.
Utilizzo di snapshot
I seguenti esempi mostrano le attività comuni quando si utilizzano gli snapshot. Per ulteriori informazioni sugli snapshot, consulta Snapshot di dischi permanenti.
Snapshot scheda
Esegui questo comando per visualizzare tutti gli snapshot di un progetto:
gcloud compute snapshots list
Per ulteriori informazioni sulla descrizione degli snapshot, consulta la documentazione di riferimento di gcloud compute snapshots list
.
Descrizione degli snapshot
Esegui questo comando per visualizzare tutti i dati associati a uno snapshot:
gcloud compute snapshots describe SNAPSHOT_NAME
Sostituisci SNAPSHOT_NAME
con il nome dello snapshot.
Per ulteriori informazioni sulla descrizione degli snapshot, consulta la documentazione di riferimento di gcloud compute snapshots describe
.
Eliminazione degli snapshot
Esegui questo comando per eliminare uno snapshot:
gcloud compute snapshots delete SNAPSHOT_NAME
Sostituisci SNAPSHOT_NAME
con il nome dello snapshot.
Per ulteriori informazioni sull'eliminazione degli snapshot, consulta
Eliminazione di uno snapshot
e la
documentazione di riferimento
gcloud compute snapshots delete
.
Utilizzo delle regole firewall
I seguenti esempi mostrano le attività comuni quando si utilizzano le regole firewall. Per ulteriori informazioni sulle regole firewall, consulta la panoramica delle regole firewall VPC.
Descrizione delle regole firewall
Esegui questo comando per visualizzare tutti i dati associati a una regola firewall:
gcloud compute firewall-rules describe FIREWALL_RULE_NAME
Sostituisci FIREWALL_RULE_NAME
con il nome della regola firewall.
Per ulteriori informazioni sulla descrizione delle regole firewall, consulta la documentazione di riferimento di gcloud compute firewall-rules describe
.
Creazione delle regole firewall
Esegui questo comando per creare una regola firewall:
gcloud compute firewall-rules create FIREWALL_RULE_NAME \ [--allow=PROTOCOL:PORT | --action=ACTION --rules=PROTOCOL:PORT]
Specifica --allow
o --action
e --rules
e sostituisci quanto segue:
FIREWALL_RULE_NAME
: il nome della regola firewall.ACTION
: l'azione in caso di corrispondenza.allow
odeny
.PROTOCOL:PORT
: il protocollo e la porta il cui traffico sarà interessato dalla regola firewall.
Per ulteriori informazioni sulla creazione di regole firewall, consulta Creazione di regole firewall e la documentazione di riferimento di gcloud compute firewall-rules create
.
Utilizzo dei gruppi di istanze gestite
I seguenti esempi mostrano le attività comuni quando si utilizzano i gruppi di istanze gestite. Per saperne di più sui gruppi di istanze gestite, consulta Gruppi di istanze gestite.
Creazione di gruppi di istanze gestite
Esegui questo comando per creare un gruppo di istanze gestite:
gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \ --size=SIZE \ --template=INSTANCE_TEMPLATE
Sostituisci quanto segue:
INSTANCE_GROUP_NAME
: il nome di questo gruppo di istanzeSIZE
: la dimensione del gruppo di istanzeINSTANCE_TEMPLATE
: il nome del modello di istanza da utilizzare per questo gruppo
Per ulteriori informazioni sulla creazione di gruppi di istanze gestite, consulta Scenari di base per la creazione di un gruppo di istanze gestite e la documentazione di riferimento di gcloud compute instance-groups managed create
.
Impostazione della scalabilità automatica
Esegui questo comando per impostare la scalabilità automatica in un gruppo di istanze gestite, in base all'utilizzo della CPU:
gcloud compute instance-groups managed set-autoscaling INSTANCE_GROUP_NAME \ --max-num-replicas=MAX_NUM_REPLICAS \ --target-cpu-utilization=TARGET_CPU_UTILIZATION
Sostituisci quanto segue:
INSTANCE_GROUP_NAME
: il nome di un gruppo di istanze gestiteMAX_NUM_REPLICAS
: numero massimo di repliche che può creare il gestore della scalabilità automaticaTARGET_CPU_UTILIZATION
: il livello di CPU che deve essere mantenuto dal gestore della scalabilità automatica, tra0.0
e1.0
Per saperne di più sull'impostazione della scalabilità automatica, consulta Gruppi di istanze con scalabilità automatica e la documentazione di riferimento di gcloud compute instance-groups managed set-autoscaling
.
Utilizzo dei metadati
L'esempio seguente mostra un'attività comune quando si utilizzano i metadati. Per ulteriori informazioni sui metadati, consulta la pagina relativa all'archiviazione e al recupero dei metadati.
Aggiunta di metadati a livello di progetto
Esegui questo comando per aggiungere metadati al tuo progetto:
gcloud compute project-info add-metadata VM_NAME \ --metadata=KEY=VALUE,[KEY=VALUE]
Sostituisci quanto segue:
VM_NAME
: il nome della VMKEY=VALUE
: la coppia chiave-valore dei metadati
Per saperne di più sull'aggiunta di metadati alle VM, consulta Impostazione di metadati personalizzati a livello di progetto e la documentazione di riferimento di gcloud compute project-info add-metadata
.
Aggiunta di metadati a livello di istanza
Esegui questo comando per aggiungere metadati a una VM:
gcloud compute instances add-metadata VM_NAME \ --metadata=KEY=VALUE,[KEY=VALUE]
Sostituisci quanto segue:
VM_NAME
: il nome della VMKEY=VALUE
: la coppia chiave-valore dei metadati
Per ulteriori informazioni sull'aggiunta di metadati alle VM, consulta Impostare i metadati delle istanze e la documentazione di riferimento di gcloud compute instances add-metadata
.
Accesso alle pagine della guida
I comandi seguenti mostrano come accedere ai diversi tipi di guida, dalla guida generica sul comando gcloud compute
alla guida specifica per un gruppo di risorse (instances
) o un comando (create
). La guida completa per tutte le risorse e i comandi segue questo schema:
gcloud compute --help
gcloud compute instances --help
gcloud compute instances create --help
Puoi consultare una guida rapida utilizzando il flag -h
anziché il flag --help
.
Puoi anche consultare tutta la guida completa nella pagina
Riferimento a Google Cloud CLI.
Per una guida completa con i comandi specifici per la configurazione di gcloud CLI, esegui:
gcloud topic TOPIC
Sostituisci TOPIC
con l'argomento per il quale vuoi ricevere assistenza. Per un elenco degli argomenti per i quali puoi ricevere assistenza, consulta la documentazione di riferimento di gcloud topic
.
Che cosa succede dopo?
- Consulta la scheda di riferimento di Google Cloud CLI per informazioni sui comandi go-to per diversi prodotti Google Cloud.