Questo documento spiega come creare un'istanza Compute Engine da un'immagine personalizzata condivisa da un altro progetto. Un'istanza contiene un bootloader, un file system di avvio e un'immagine sistema operativo. Puoi creare immagini personalizzate da dischi di origine, immagini, snapshot o immagini archiviate in Cloud Storage e usarle per creare istanze. Per impostazione predefinita, un'immagine personalizzata appartiene solo al progetto in cui è stata creata. Se un altro utente ha condiviso un'immagine con te, puoi utilizzarla per creare un'istanza.
Prima di iniziare
- Quando crei istanze da immagini utilizzando Google Cloud CLI o l'API Compute Engine, è previsto un limite di 20 istanze al secondo. Se devi creare un numero maggiore di istanze al secondo, richiedi un aggiustamento della quota per la risorsa Immagini.
-
Se non l'hai ancora fatto, configura l'autenticazione.
L'autenticazione è il processo mediante il quale la tua identità viene verificata per l'accesso a servizi e API di Google Cloud .
Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su
Compute Engine selezionando una delle seguenti opzioni:
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
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.
- Set a default region and zone.
-
compute.instances.create
sul progetto -
Per utilizzare un'immagine condivisa per creare l'istanza:
compute.images.useReadOnly
sull'immagine Nella consoleGoogle Cloud , vai alla pagina Crea un'istanza.
Se richiesto, seleziona il progetto e fai clic su Continua.
Viene visualizzata la pagina Crea un'istanza, che contiene il riquadro Configurazione macchina.
Nel riquadro Configurazione macchina, segui questi passaggi:
- Nel campo Nome, specifica un nome per l'istanza. Per saperne di più, consulta le convenzioni per la denominazione delle risorse.
(Facoltativo) Nel campo Zona, seleziona una zona per l'istanza.
La selezione predefinita è Qualsiasi. Se non modifichi questa selezione predefinita, Google sceglie automaticamente una zona in base al tipo di macchina e alla disponibilità.
Seleziona la famiglia di macchine per l'istanza. La consoleGoogle Cloud mostra quindi le serie di macchine disponibili per la famiglia di macchine selezionata. Sono disponibili le seguenti opzioni per la famiglia di macchine:
- Per uso generico
- Ottimizzata per il calcolo
- Ottimizzata per la memoria
- Ottimizzata per l'archiviazione
- GPU
Nella colonna Serie, seleziona la serie di macchine per la tua istanza.
Se nel passaggio precedente hai selezionato GPU come famiglia di macchine, seleziona il tipo di GPU che preferisci. La serie di macchine viene quindi selezionata automaticamente per il tipo di GPU selezionato.
Nella sezione Tipo di macchina, seleziona il tipo di macchina per la tua istanza.
Nel menu di navigazione, fai clic su Sistema operativo e spazio di archiviazione. Nel riquadro Sistema operativo e spazio di archiviazione visualizzato, configura il disco di avvio seguendo questi passaggi:
- Fai clic su Cambia. Viene visualizzato il riquadro Disco di avvio con la scheda Immagini pubbliche.
- Fai clic su Immagini personalizzate. Viene visualizzata la scheda Immagini personalizzate.
- Per selezionare il progetto dell'immagine, fai clic su Modifica, quindi seleziona il progetto che contiene l'immagine.
- Nell'elenco Immagine, seleziona l'immagine che vuoi importare.
- Nell'elenco Tipo di disco di avvio, seleziona il tipo di disco di avvio.
- Nel campo Dimensioni (GB), specifica le dimensioni del disco di avvio.
- (Facoltativo) Per i dischi di avvio Hyperdisk bilanciato, specifica i valori per i campi IOPS sottoposte a provisioning e Throughput riservato.
- (Facoltativo) Per le opzioni di configurazione avanzata, espandi la sezione Mostra configurazioni avanzate.
- Per confermare le opzioni del disco di avvio e tornare al riquadro Sistema operativo e spazio di archiviazione, fai clic su Seleziona.
Nel menu di navigazione, fai clic su Networking. Nel riquadro Networking visualizzato, segui questi passaggi:
- Vai alla sezione Firewall.
Per consentire il traffico HTTP o HTTPS all'istanza, seleziona Consenti traffico HTTP o Consenti traffico HTTPS.
Compute Engine aggiunge un tag di rete all'istanza e crea la regola firewall in entrata corrispondente che consente tutto il traffico in entrata su
tcp:80
(HTTP) otcp:443
(HTTPS). Il tag di rete associa la regola firewall all'istanza. Per saperne di più, consulta la Panoramica delle regole firewall nella documentazione di Cloud Next Generation Firewall.
(Facoltativo) Specifica altre opzioni di configurazione. Per saperne di più, consulta Opzioni di configurazione durante la creazione dell'istanza.
Per creare e avviare l'istanza, fai clic su Crea.
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Crea un'istanza utilizzando il
gcloud compute instances create command
e i flag--image
e--image-project
per specificare il nome dell'immagine e il progetto in cui si trova:gcloud compute instances create INSTANCE_NAME \ --image=IMAGE \ --image-project=IMAGE_PROJECT
Sostituisci quanto segue:
INSTANCE_NAME
: il nome della nuova istanzaIMAGE
: il nome dell'immagineIMAGE_PROJECT
: il progetto a cui appartiene l'immagine
Se il comando ha esito positivo,
gcloud
risponde con le proprietà della nuova istanza, come nell'esempio seguente:Created [https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-b/instances/example-instance]. NAME ZONE MACHINE_TYPE PREEMPTIBLE INTERNAL_IP EXTERNAL_IP STATUS example-instance us-central1-b e2-standard-2 10.240.0.4 104.198.53.60 RUNNING
- Nella console Google Cloud , vai alla pagina Istanze VM.
- Fai clic su Crea istanza.
- Specifica i parametri che ti interessano.
- Nella parte superiore o inferiore della pagina, fai clic su Codice equivalente e quindi sulla scheda Terraform per visualizzare il codice Terraform.
PROJECT_ID
: l'ID del progetto in cui creare la VMZONE
: la zona in cui creare la VMMACHINE_TYPE_ZONE
: la zona contenente il tipo di macchina da utilizzare per la nuova VMMACHINE_TYPE
: il tipo di macchina, predefinita o personalizzata, per la nuova VMVM_NAME
: il nome della nuova VMIMAGE_PROJECT
: il nome del progetto che contiene l'immagine condivisaIMAGE
: specifica una delle seguenti opzioni:IMAGE
: il nome dell'immagine condivisa. Ad esempio,"sourceImage": "projects/finance-project-1234/global/images/finance-debian-image-v2"
.IMAGE_FAMILY
: se l'immagine condivisa viene creata all'interno di una famiglia di immagini personalizzate, specifica la famiglia di immagini personalizzate.In questo modo la VM viene creata dall'immagine sistema operativo più recente e non deprecata nella famiglia di immagini personalizzate. Ad esempio, se specifichi
"sourceImage": "projects/finance-project-1234/global/images/family/finance-debian-family"
, Compute Engine crea una VM dall'ultima versione dell'immagine sistema operativo nella famiglia di immagini personalizzatafinance-debian-family
.
NETWORK_NAME
: la rete VPC che vuoi utilizzare per la VM. Puoi specificaredefault
per utilizzare la rete predefinita.ENABLE_SECURE_BOOT
: (Facoltativo) se hai scelto un'immagine che supporta le funzionalità Shielded VM, Compute Engine attiva per impostazione predefinita il Trusted Platform Module virtuale (vTPM) e il monitoraggio dell'integrità. Compute Engine non attiva l'Avvio protetto per impostazione predefinita.Se specifichi
true
perenableSecureBoot
, Compute Engine crea una VM con tutte e tre le funzionalità Shielded VM attivate. Dopo che Compute Engine ha avviato la VM, per modificare le opzioni Shielded VM devi arrestarla.- Scopri di più sulle immagini personalizzate e su come condividerle.
- Scopri come controllare lo stato di un'istanza per sapere quando è pronta per l'uso.
- Scopri come connetterti all'istanza.
REST
Per utilizzare gli esempi dell'API REST in questa pagina in un ambiente di sviluppo locale, utilizza le credenziali fornite a gcloud CLI.
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.
Per ulteriori informazioni, consulta Eseguire l'autenticazione per l'utilizzo di REST nella documentazione Google Cloud sull'autenticazione.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per creare un'istanza da un'immagine condivisa, chiedi all'amministratore di concederti il ruolo IAM Compute Instance Admin (v1) (
roles/compute.instanceAdmin.v1
) sul progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.Questo ruolo predefinito contiene le autorizzazioni necessarie per creare un'istanza da un'immagine condivisa. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
Per creare un'istanza da un'immagine condivisa sono necessarie le seguenti autorizzazioni:
Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.
Crea un'istanza da un'immagine condivisa
Per creare un'istanza da un'immagine condivisa:
Console
gcloud
Terraform
La procedura per creare un'istanza con un'immagine condivisa in Terraform è la stessa della creazione di un'istanza con un'immagine disponibile pubblicamente.
REST
La procedura per creare un'istanza con un'immagine condivisa nell'API è la stessa della creazione di un'istanza con un'immagine disponibile pubblicamente.
Per creare l'istanza da un'immagine condivisa, utilizza il metodo
instances.insert
.POST https://compute.googleapis.com/compute/v1/projects/
PROJECT_ID
/zones/ZONE
/instances { "machineType":"zones/MACHINE_TYPE_ZONE/machineTypes/MACHINE_TYPE", "name":"VM_NAME
", "disks":[ { "initializeParams":{ "sourceImage":"projects/IMAGE_PROJECT/global/images/IMAGE" }, "boot":true } ], "networkInterfaces":[ { "network":"global/networks/NETWORK_NAME" } ], "shieldedInstanceConfig":{ "enableSecureBoot":"ENABLE_SECURE_BOOT" } }Sostituisci quanto segue:
Passaggi successivi
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-06-30 UTC.
-