Esegui la transizione da gcutil a gcloud compute

Con gcloud compute in disponibilità generale, Compute Engine consiglia a tutti gli utenti di eseguire la transizione allo strumento gcloud compute da gcutil. gcloud compute è uno strumento a riga di comando unificato che offre una serie di miglioramenti rispetto a gcutil, tra cui:

  • Completamento
  • Upgrade in loco
  • Guida completa in stile pagina di manuale
  • Scelta di diversi formati di output

Per aiutare gli utenti a passare da gcutil a gcloud compute, questa guida descrive brevemente le principali differenze tra i due strumenti. Per una descrizione dettagliata dello strumento gcloud compute, consulta la documentazione di gcloud compute.

Nuovi comandi di gcloud

Tutti i comandi di gcutil esistenti hanno comandi equivalenti nello strumento gcloud compute, con alcune eccezioni. Per un elenco completo dei comandi di gcloud, visita le pagine di riferimento o esegui gcloud compute --help. La tabella riportata di seguito illustra brevemente le modifiche apportate ai comandi di gcutil più utilizzati.

Comando gcutil Comando gcloud compute 
gcutil addinstance INSTANCE
 
gcloud compute instances create INSTANCE
Note

Crea un'istanza.

  • È possibile impostare una zona/regione predefinita, altrimenti "gcloud compute" richiede una zona/regione.
  • Crea macchine virtuali con proprietà predefinite, ad esempio:
    • tipo di macchina: n1-standard-1
    • immagine: debian-10

Consulta la sezione Crea e avvia un'istanza.

Comando gcutil Comando gcloud compute 
gcutil deleteinstance INSTANCE
 
gcloud compute instances delete INSTANCE \
       [--keep-disks {boot,all,none}]
Note

Elimina le istanze. Consulta Elimina un'istanza.
Comando gcutil Comando gcloud compute 
gcutil ... --cache_flag_values
 
gcloud configs set project PROJECT
gcloud configs set compute/zone ZONE
gcloud configs set compute/region REGION
Note

Imposta i valori predefiniti per progetto, zona e regione. Consulta Imposta una zona e una regione predefinite.
Comando gcutil Comando gcloud compute 
gcutil push/pull
 
gcloud compute scp
Note

Copia i file tra un computer locale e una macchina virtuale. Consulta Trasferisci file utilizzando Google Cloud CLI.
Comando gcutil Comando gcloud compute 
gcutil deleteRESOURCE
 
gcloud compute RESOURCES delete
Note

Elimina le risorse, ad esempio: 

gcloud compute instances delete example-instance
Comando gcutil Comando gcloud compute 
gcutil getRESOURCES
 
gcloud compute RESOURCES describe
Note

Descrive una singola risorsa, ad esempio: 

gcloud compute instances describe example-instance
Comando gcutil Comando gcloud compute 
gcutil listRESOURCES
 
gcloud compute RESOURCES list
Note

Elenca tutte le risorse di quel tipo. Ad esempio, per elencare le istanze: 

gcloud compute instances list
Comando gcutil Comando gcloud compute 
gcutil setmetadata
 
gcloud compute instances add-metadata
gcloud compute instances remove-metadata
gcloud compute project-info add-metadata
gcloud compute project-info remove-metadata
Note

Il blocco ottimistico viene ora eseguito dallo strumento, quindi non è necessario specificare manualmente un'impronta. Consulta Imposta metadati personalizzati dell'istanza.
Comando gcutil Comando gcloud compute 
gcutil … --dump_request_response

Non ancora disponibile.
Comando gcutil Comando gcloud compute 
gcutil … --log_level=DEBUG
 
gcloud … --verbosity debug
Note

Inoltre, i log vengono archiviati in file per ogni comando in ~/.config/gcloud/logs.
Comando gcutil Comando gcloud compute 
gcutil ssh INSTANCE --ssh_user
 
gcloud compute ssh USER@INSTANCE
Note

Consulta la sezione Connettiti a un'istanza.
Comando gcutil Comando gcloud compute 
gcutil … \
--image=projects/project-id/global/images/image

gcloud compute … --image image-name \
       --image-project image-project
Note

Consulta Avvia un'istanza da un'immagine.
Comando gcutil Comando gcloud compute 
gcutil deleteinstances --[no]delete_pd
gcutil deleteinstances --[no]delete_boot_pd

gcloud compute instances delete … \
       --delete-disks {all,none,boot}
gcloud compute instances delete … \
       --keep-disks {all,none,boot}
Note

Se un disco è contrassegnato per l'eliminazione automatica, verrà eliminato automaticamente, a meno che non sia specificato con il flag --keep-disks.

Impostazioni predefinite per le istanze

La creazione di un'istanza in gcloud compute ora prevede diversi valori predefiniti per l'immagine e il tipo di macchina della macchina virtuale. Puoi scegliere di utilizzare questi valori predefiniti omettendo i flag --image e --machine-type oppure eseguire l'override delle impostazioni specificando i flag appropriati. Le impostazioni predefinite della macchina virtuale sono:

  • Immagine predefinita: immagine debian-10 più recente
  • Tipo di macchina predefinito: n1-standard-1

Ad esempio, puoi semplicemente eseguire:

gcloud compute instances create example-instance --zone us-central1-a

gcloud compute creerà l'istanza utilizzando l'immagine e il tipo di macchina descritti sopra.

Formattazione dell'output

La formattazione predefinita dell'output è cambiata e varia a seconda del comando eseguito. Ad esempio, se esegui il comando describe per ottenere informazioni su una singola risorsa, l'output della risposta è in formato YAML. Puoi restituire la risposta in diversi formati di output, come JSON o testo, utilizzando il flag --format:

gcloud compute instances list --format {json,yaml,text}

Ora l'aggiornamento dei metadati è additivo

Per impostare o aggiornare i metadati non è più necessario fornire un'impronta. Per impostazione predefinita, tutte le modifiche ai metadati sono considerate additive. Puoi aggiungere singole voci di metadati o aggiornarle senza eseguire un aggiornamento batch di tutti i metadati. Verranno modificate solo le chiavi dei metadati passate.

gcloud compute instances add-metadata example-instance \
         --metadata cookies=chocolate

Specifica i progetti di immagini

In precedenza, per specificare un'immagine esatta, era necessario fornire un URI parziale per l'immagine, che includeva il nome del progetto, nel modo seguente:

gcutil addinstance example-instance \
         --image=projects/debian-cloud/global/images/debian-9

In gcloud compute ora devi specificare il progetto di immagine utilizzando un nuovo flag --image-project:

gcloud compute instances create example-instance \
         --image debian-9-stretch-vYYYMMDD
         --image-project debian-cloud

Puoi anche specificare l'URI completo:

gcloud compute instances create example-instance \
         --image https://compute.googleapis.com/compute/v1/projects/debian-cloud/global/images/debian-9-stretch-vYYYMMDD