Comandi gcloud compute comuni

Questo documento elenca alcuni dei comandi gcloud compute più utilizzati.

Prima di iniziare

  • Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è il processo mediante il quale la tua identità viene verificata per l'accesso ai Google Cloud servizi e alle API. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine selezionando una delle seguenti opzioni:

    1. After installing the Google Cloud CLI, initialize it by running the following command: 

      gcloud init

      If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    2. Set a default region and zone.

Descrivere i progetti

Esegui il comando seguente per eseguire query sulle informazioni relative al tuo progetto Compute Engine, come metadati del progetto, chiavi SSH e metriche di quota:

 gcloud compute project-info describe

Per saperne di più sulla descrizione del progetto, consulta la documentazione di riferimento di gcloud compute project-info describe.

Utilizzo delle VM

Gli esempi riportati di seguito mostrano le attività comuni quando si lavora con le istanze di macchina virtuale (VM). Per ulteriori informazioni sulle istanze di macchine virtuali (VM), consulta Istanze di macchine virtuali.

Creazione di 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 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, la VM viene creata dall'immagine sistema operativo più recente e 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 di VM, consulta Creazione e avvio di un'istanza VM e la documentazione di riferimento gcloud compute instances create.

Elenco delle VM

Esegui questo comando per visualizzare tutte le VM in un progetto:

gcloud compute instances list

Per saperne di più sull'elenco delle VM, consulta la documentazione di riferimento 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 saperne di più sulla descrizione delle VM, consulta la documentazione di riferimento relativa a 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 ulteriori informazioni sull'avvio delle VM, consulta Avvio e arresto di un'istanza e la documentazione di riferimento 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 gcloud compute instances stop.

Aggiungi 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 saperne di più sull'assegnazione di etichette alle VM, consulta Etichettare le risorse e la documentazione di riferimento gcloud compute instances add-labels.

Connessione alle VM

Utilizzo di SSH per la connessione alle istanze

Esegui il seguente comando per connetterti a una VM utilizzando SSH:

gcloud compute ssh VM_NAME

Sostituisci VM_NAME con il nome della VM.

Per saperne di più sulla connessione alle VM tramite SSH, consulta Connessione alle VM Linux e la gcloud compute ssh documentazione di riferimento.

Utilizzare SCP per trasferire 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 utilizzando Google Cloud CLI e la gcloud compute scp documentazione di riferimento.

Utilizzo dei dischi

Il seguente esempio mostra un'attività comune quando si lavora con i dischi. Per saperne di più 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 saperne di più sull'elenco dei dischi, consulta la gcloud compute disks list documentazione di riferimento.

Utilizzo di snapshot

I seguenti esempi mostrano le attività comuni quando si lavora con gli snapshot. Per saperne di più sugli snapshot, consulta la sezione Snapshot di dischi permanenti.

Elenco degli snapshot

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

gcloud compute snapshots list

Per saperne di più sulla descrizione degli snapshot, consulta la gcloud compute snapshots list documentazione di riferimento.

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

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 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 lavora con le regole firewall. Per maggiori informazioni sulle regole firewall, consulta 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 saperne di più sulla descrizione delle regole firewall, consulta la gcloud compute firewall-rules describe documentazione di riferimento.

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

Per saperne di più sulla creazione di regole firewall, vedi Creazione di regole firewall e la documentazione di riferimento gcloud compute firewall-rules create.

Utilizzo dei gruppi di istanze gestite (MIG)

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

Creazione di gruppi di istanze gestite

Esegui questo comando per creare un MIG:

gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
    --size=SIZE \
    --template=INSTANCE_TEMPLATE_URL

Sostituisci quanto segue:

  • INSTANCE_GROUP_NAME: il nome di questo gruppo di istanze
  • SIZE: la dimensione del gruppo di istanze
  • INSTANCE_TEMPLATE_URL: l'URL del modello di istanza che vuoi utilizzare per creare le VM nel MIG. L'URL può contenere l'ID o il nome del modello di istanza. Specifica uno dei seguenti valori:
    • Per un modello di istanza regionale: projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID
    • Per un modello di istanza globale: INSTANCE_TEMPLATE_ID

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

Impostazione della scalabilità automatica

Esegui il seguente comando per impostare la scalabilità automatica su un MIG 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 MIG
  • MAX_NUM_REPLICAS: il numero massimo di repliche che il gestore della scalabilità automatica può creare
  • TARGET_CPU_UTILIZATION: il livello di CPU che il gestore della scalabilità automatica deve mantenere, compreso tra 0.0 e 1.0

Per saperne di più sull'impostazione della scalabilità automatica, consulta Gruppi di istanze a scalabilità automatica e la documentazione di riferimento gcloud compute instance-groups managed set-autoscaling.

Utilizzo dei metadati

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

Aggiunta di metadati a livello di progetto

Esegui questo comando 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 saperne di più sull'aggiunta di metadati alle VM, consulta Impostazione di metadati personalizzati a livello di progetto e la documentazione di riferimento 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 la documentazione di riferimento gcloud compute instances add-metadata.

Accesso alle pagine della guida

I seguenti comandi mostrano come accedere a 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 la guida completa nel riferimento per Google Cloud CLI.

Per una guida completa con i comandi appositi per la configurazione di gcloud CLI, esegui:

gcloud topic TOPIC

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

Passaggi successivi