Comandi comuni di gcloud compute

Questo documento elenca alcuni dei comandi gcloud compute di uso più comune.

Prima di iniziare

  • Se non l'hai ancora fatto, configura l'autenticazione. Autenticazione è Il processo di verifica dell'identità per l'accesso ai servizi e alle API di Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi eseguire l'autenticazione Compute Engine come segue.

    1. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

Descrivere i progetti

Esegui il seguente comando per eseguire query sulle informazioni del progetto Compute Engine, ad esempio metadati del progetto, chiavi SSH e metriche relative alle quote:

 gcloud compute project-info describe

Per ulteriori informazioni sulla descrizione del progetto, consulta gcloud compute project-info describe documentazione di riferimento.

Utilizzo delle VM

Gli esempi seguenti mostrano attività comuni quando si lavora con una macchina virtuale (VM) di Compute Engine. Per ulteriori informazioni sulle istanze di macchine virtuali (VM), consulta Istanze di macchine virtuali.

Creazione di VM

Esegui il comando seguente 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 name della nuova VM.
  • IMAGE o IMAGE_FAMILY: Specifica una delle seguenti opzioni:
    • IMAGE: versione richiesta di un'immagine pubblica. Ad esempio, --image debian-10-buster-v20200309.
    • IMAGE_FAMILY: una famiglia di immagini. In questo modo viene creata la VM dall'immagine del sistema operativo più recente e non ritirata. Ad esempio: Se specifichi --image-family debian-10, Compute Engine crea una VM dalla versione più recente dell'immagine sistema operativo nella famiglia di immagini Debian 10.
  • IMAGE_PROJECT: il project contenente l'immagine.

Per saperne di più sulla creazione di VM, consulta Creazione e avvio di un'istanza VM e ai gcloud compute instances create documentazione di riferimento.

Elenco delle VM

Esegui il comando seguente per visualizzare tutte le VM in un progetto:

gcloud compute instances list

Per ulteriori informazioni sull'elenco delle VM, consulta gcloud compute instances list documentazione di riferimento.

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 il seguente comando per visualizzare tutte le VM con unità SSD locali in un progetto:

gcloud compute instances list  --filter="disks.type='SCRATCH'"  --format="table(name,zone,guestAccelerators.acceleratorType,guestAccelerators.acceleratorCount,disks.type)"

Descrivere le 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 gcloud compute instances describe documentazione di riferimento.

VM in fase di avvio

Esegui il seguente comando per avviare una VM interrotta:

gcloud compute instances start VM_NAME

Sostituisci VM_NAME con il nome della VM.

Per ulteriori informazioni sull'avvio delle VM, consulta Avvio e arresto di un'istanza e la documentazione di riferimento di gcloud compute instances start.

Arresto delle VM in corso...

Esegui il seguente 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 la sezione Avvio e arresto di un'istanza e la documentazione di riferimento di gcloud compute instances stop.

Aggiunta di etichette alle VM

Esegui il seguente 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 saperne di più sull'etichettatura delle VM, consulta la sezione Etichettatura delle risorse e la documentazione di riferimento di gcloud compute instances add-labels.

Connessione alle VM

Utilizzo di SSH per la connessione 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 trasferire file nelle istanze

Esegui il seguente 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 utilizzando l'interfaccia a riga di comando Google Cloud e la documentazione di riferimento gcloud compute scp.

Utilizzo dei dischi

L'esempio seguente mostra un'attività comune quando si lavora con i dischi. Per maggiori informazioni 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

Gli esempi seguenti mostrano le attività comuni quando si utilizzano gli snapshot. Per maggiori informazioni per informazioni sugli snapshot, Snapshot di dischi permanenti.

Elenco snapshot

Esegui questo comando per visualizzare tutti gli snapshot di un progetto:

gcloud compute snapshots list

Per saperne di più 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 saperne di più 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 saperne di più sull'eliminazione degli snapshot, consulta la sezione Eliminare uno snapshot e la documentazione di riferimento di gcloud compute snapshots delete.

Utilizzo delle regole firewall

Gli esempi riportati di seguito mostrano le attività comuni quando si utilizzano le regole del firewall. Per ulteriori informazioni sulle regole firewall, consulta la panoramica delle regole firewall VPC.

Descrizione delle regole firewall

Esegui il seguente 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 del firewall personalizzata.

Per ulteriori informazioni sulla descrizione delle regole firewall, consulta la documentazione di riferimento di gcloud compute firewall-rules describe.

Creazione delle regole firewall in corso...

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 o deny.
  • PROTOCOL:PORT: il protocollo e la porta traffico sarà influenzato dalla regola firewall.

Per ulteriori informazioni sulla creazione di regole firewall, consulta la sezione Creare regole firewall e la documentazione di riferimento di gcloud compute firewall-rules create.

Utilizzo dei gruppi di istanze gestite

Gli esempi seguenti mostrano le attività comuni quando si lavora con i gruppi di istanze gestite. Per maggiori informazioni sui gruppi di istanze gestite, consulta la pagina Gruppi di istanze gestite (MIG).

Creazione di gruppi di istanze gestite

Esegui il comando seguente 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 istanze
  • SIZE: la dimensione del gruppo di istanze
  • INSTANCE_TEMPLATE: il nome del modello di istanza da utilizzare per questo gruppo

Per saperne di più sulla creazione di gruppi di istanze gestite, consulta Scenari di base per la creazione di un gruppo di istanze gestite e ai gcloud compute instance-groups managed create documentazione di riferimento.

Impostazione della scalabilità automatica

Esegui questo comando per impostare la scalabilità automatica su 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 gestite
  • MAX_NUM_REPLICAS: il numero massimo di repliche che il gestore della scalabilità automatica può creare
  • TARGET_CPU_UTILIZATION: il livello di CPU che deve essere mantenuto dall'autoscaler, compreso tra 0.0 e 1.0

Per ulteriori informazioni sull'impostazione della scalabilità automatica, consulta Gruppi di istanze con scalabilità automatica e ai gcloud compute instance-groups managed set-autoscaling documentazione di riferimento.

Utilizzo dei metadati

L'esempio seguente mostra un'attività comune quando si lavora con i metadati. Per ulteriori informazioni sui metadati, consulta la sezione Archiviazione e recupero dei metadati.

Aggiunta di metadati a livello di progetto

Esegui il comando seguente per aggiungere metadati al progetto:

gcloud compute project-info add-metadata VM_NAME \
    --metadata=KEY=VALUE,[KEY=VALUE]

Sostituisci quanto segue:

  • VM_NAME: il nome della VM
  • KEY=VALUE: la coppia chiave-valore dei metadati

Per ulteriori informazioni sull'aggiunta di metadati alle VM, consulta Impostare 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 il comando seguente 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 VM
  • KEY=VALUE: la coppia chiave-valore dei metadati

Per saperne di più sull'aggiunta di metadati alle VM, consulta Impostazione dei metadati dell'istanza e ai gcloud compute instances add-metadata documentazione di riferimento.

Accesso alle pagine della guida

I seguenti comandi mostrano come accedere a diversi tipi di strumenti 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 la guida completa all'indirizzo Riferimento per Google Cloud CLI.

Per una guida completa con i comandi appositi per la configurazione dell'interfaccia a riga di comando gcloud, esegui:

gcloud topic TOPIC

Sostituisci TOPIC con l'argomento per cui ti serve assistenza. Per un elenco degli argomenti per cui è disponibile la guida, consulta la documentazione di riferimento di gcloud topic.

Passaggi successivi