Utilizza un'immagine macchina per archiviare tutte le configurazioni, i metadati, le autorizzazioni e i dati di più dischi per un'istanza VM in esecuzione su Compute Engine. L'istanza VM che utilizzi per creare un'immagine macchina è detta istanza VM di origine.
Per informazioni su quando e come utilizzare le immagini macchina, consulta Immagini macchina.
Questo documento descrive i passaggi per creare un'immagine macchina da un'istanza VM di origine.
Prima di iniziare
-
Se non l'hai già fatto, configura l'autenticazione.
L'autenticazione è il processo mediante il quale viene verificata l'identità dell'utente per ottenere l'accesso ai servizi e alle API Google Cloud.
Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi eseguire l'autenticazione in Compute Engine come segue.
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
-
Installa Google Cloud CLI, quindi initialize eseguendo questo comando:
gcloud init
- Set a default region and zone.
- Puoi creare un'immagine macchina al massimo una volta ogni 10 minuti. Se vuoi inviare una serie di richieste per la creazione di più immagini macchina da un'istanza, puoi inviare al massimo 6 richieste in 60 minuti.
- Puoi proteggere un'immagine della macchina utilizzando Cloud Key Management Service (Cloud KMS) o una chiave di crittografia fornita dal cliente (CSEK). La chiave di crittografia protegge il contenuto dei dischi. Tuttavia, i metadati non sono protetti.
- Se utilizzi una CSEK per proteggere l'immagine della tua macchina, durante la generazione dell'immagine della macchina viene archiviata una copia completa di tutti i dati del disco. In tutti gli altri scenari, i dati del disco vengono archiviati in copie differenziali.
Non puoi creare immagini macchina da VM di origine che:
- Avere più di 200 TB di dischi collegati.
- Nessun disco collegato.
- Avere eventuali dischi Hyperdisk Extreme collegati.
- Utilizzare un tipo di macchina C3D, H3, A3 o Z3
disks.architecture
disks.description
disks.labels
disks.locked
disks.multiWriter
disks.onUpdateAction
disks.provisionedIops
disks.shieldedInstanceInitialState
disks.sourceImage
disks.sourceImageEncryptionKey
disks.sourceInstantSnapshot
disks.sourceSnapshot
disks.sourceSnapshotEncryptionKey
privateIpv6GoogleAccess
resourceManagerTags
resourcePolicies
secure_tag
shieldedInstanceConfig
- Un nome per l'immagine della macchina che vuoi creare.
- Il nome dell'istanza VM di origine.
- La zona in cui si trova l'istanza VM di origine.
- Una descrizione facoltativa.
- Un elemento
storageLocation
facoltativo. Se non specifichi una località, la località di archiviazione predefinita è la località Cloud Storage multiregionale dell'istanza VM di origine. - Una chiave di crittografia facoltativa. Puoi scegliere tra una chiave di proprietà di Google e gestita da Google, una chiave di Cloud Key Management Service (Cloud KMS) o una chiave di crittografia fornita dal cliente (CSEK). Se non viene specificata alcuna chiave di crittografia, le immagini macchina vengono criptate utilizzando una chiave di proprietà di Google e gestita da Google.
Se vuoi utilizzare un'immagine macchina per clonazione e creazione di snapshot di istanze, rimuovi le informazioni relative al sistema operativo e all'app univoche per l'istanza prima di generare l'immagine macchina da un'istanza. Ad esempio, per le istanze VM Windows, utilizza
GCESysprep
per preparare il sistema per la replica.Nella console Google Cloud, vai alla pagina Immagini macchina.
Fai clic su Crea immagine macchina.
Specifica un nome per l'immagine della macchina.
(Facoltativo) Fornisci una descrizione.
Seleziona Istanza VM di origine.
(Facoltativo) Specifica dove archiviare l'immagine della macchina. Scegli tra archiviazione multiregionale o regionale. Per maggiori informazioni sulla posizione, vedi Posizione di archiviazione delle immagini della macchina.
(Facoltativo) Seleziona un metodo di Crittografia.
Fai clic su Crea.
MACHINE_IMAGE_NAME
: nome dell'immagine della macchina che vuoi creare.SOURCE_VM_NAME
: nome dell'istanza VM di origine da cui vuoi creare l'immagine.PROJECT_ID
: ID progetto.MACHINE_IMAGE_NAME
: nome dell'immagine della macchina che vuoi creare.SOURCE_INSTANCE_URL
: URL completo o parziale dell'istanza VM di origine che vuoi utilizzare per creare l'immagine macchina. ad esempio se hai un'istanza di origine denominatamy-instance
in un progetto denominatomyProject
. I seguenti URL sono validi:https://www.googleapis.com/compute/v1/projects/myProject/global/instances/my-instance
projects/myProject/global/instances/my-instance
global/instances/my-instance
- Scopri di più sulle immagini macchina
- Crea istanze VM da immagini macchina
REST
Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.
Installa Google Cloud CLI, quindi initialize eseguendo questo comando:
gcloud init
Per maggiori informazioni, consulta Autenticazione per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud.
Limitazioni e restrizioni
Proprietà dell'istanza e del disco non supportate dall'immagine macchina
Quando crei immagini macchina da istanze VM o crei istanze VM dalle immagini macchina, le seguenti proprietà di istanze e dischi non vengono conservate o ripristinate:
Creazione di un'immagine macchina da una VM
Puoi creare immagini macchina utilizzando la console Google Cloud, Google Cloud CLI o REST.
Per creare un'immagine macchina, sono necessarie le seguenti informazioni:
Console
gcloud
Utilizza il comando
gcloud compute machine-images create
per creare un'immagine macchina da un'istanza.gcloud compute machine-images create MACHINE_IMAGE_NAME \ --source-instance=SOURCE_VM_NAME
Sostituisci quanto segue:
Esempio
Ad esempio, puoi utilizzare il seguente comando
gcloud
per creare un'immagine macchina denominatamy-machine-image
da un'istanza di origine denominatamy-instance
:gcloud compute machine-images create my-machine-image \ --source-instance=my-instance
Il processo richiede alcuni minuti. Quando viene creata l'immagine della macchina, viene visualizzato un output simile al seguente:
Created [https://www.googleapis.com/compute/v1/projects/project-12345/global/machineImages/my-machine-image]. NAME STATUS my-machine-image READY
REST
Nell'API, crea una richiesta
POST
per il metodomachineimages.insert
. Nel corpo della richiesta, includi la seguente richiestaPOST
:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/machineImages { "name": "MACHINE_IMAGE_NAME", "sourceInstance": "SOURCE_INSTANCE_URL" }
Sostituisci quanto segue:
Che cosa succede dopo?
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 2024-07-12 UTC.
[{ "type": "thumb-down", "id": "hardToUnderstand", "label":"Hard to understand" },{ "type": "thumb-down", "id": "incorrectInformationOrSampleCode", "label":"Incorrect information or sample code" },{ "type": "thumb-down", "id": "missingTheInformationSamplesINeed", "label":"Missing the information/samples I need" },{ "type": "thumb-down", "id": "translationIssue", "label":"Problema di traduzione" },{ "type": "thumb-down", "id": "otherDown", "label":"Altra" }] [{ "type": "thumb-up", "id": "easyToUnderstand", "label":"Facile da capire" },{ "type": "thumb-up", "id": "solvedMyProblem", "label":"Il problema è stato risolto" },{ "type": "thumb-up", "id": "otherUp", "label":"Altra" }] -