Crea immagini macchina

---

Utilizza un'immagine macchina per archiviare tutti configurazione, metadati, autorizzazioni e dati di più dischi per una VM su Compute Engine. L'istanza VM che utilizzi per creare l'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 una VM di origine in esecuzione in un'istanza Compute Engine.

Prima di iniziare

• Se non l'hai già 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 autenticarti su 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

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

     gcloud init

     Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
  2. Set a default region and zone.

  REST

  Per utilizzare gli esempi dell'API REST in questa pagina in un ambiente di sviluppo locale, utilizza le credenziali fornite a gcloud CLI.

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

  gcloud init

  Per ulteriori informazioni, vedi Esegui l'autenticazione per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud.

Limitazioni e restrizioni

• Puoi creare un'immagine macchina di un'istanza specifica al massimo 6 volte ogni 60 minuti.
• Puoi proteggere un'immagine macchina utilizzando Cloud Key Management Service (Cloud KMS) o un chiave di crittografia fornita dal cliente (CSEK). La chiave di crittografia protegge il contenuto dei dischi. Tuttavia, i metadati non sono protette.
• Se utilizzi una CSEK per proteggere l'immagine della tua macchina, verrà eseguita una copia completa di tutti i dati del disco durante la generazione dell'immagine macchina. In tutti gli altri scenari i dati del disco sono archiviati copie differenziali.

• Non puoi creare immagini macchina da VM di origine che:

  • Avere più di 200 TB di dischi collegati.
  • Non avere dischi collegati.
  • Avere eventuali dischi Hyperdisk Extreme collegati.
  • Utilizzare un tipo di macchina C3D, H3, A3 o Z3

Proprietà dell'istanza e del disco non supportate dall'immagine macchina

Quando crei immagini macchina da istanze VM o crei istanze VM immagini macchina, le seguenti proprietà di istanza e disco non vengono conservate o ripristinato:

• 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

Creazione di un'immagine macchina da una VM

Autorizzazioni richieste per questa attività

Per eseguire questa attività, devi disporre di quanto segue autorizzazioni:

• compute.machineImages.create nel progetto
• compute.instances.useReadOnly sull'istanza di origine
• compute.disks.createSnapshot sul disco

Puoi creare immagini macchina utilizzando Console Google Cloud, Google Cloud CLI, oppure REST.

Per creare un'immagine macchina, sono necessarie le seguenti informazioni:

• 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 posizione di archiviazione predefinita è località Cloud Storage in più regioni dell'istanza VM di origine.
• Una chiave di crittografia facoltativa. Puoi scegliere tra una chiave di proprietà di Google e una gestita da Google, un Cloud Key Management Service (Cloud KMS) o una chiave crittografia fornita dal cliente (CSEK) chiave. Se non viene specificata alcuna chiave di crittografia, le immagini macchina vengono criptate utilizzando una chiave di proprietà di Google.

• Se vuoi utilizzare un'immagine macchina clonazione e creazione di snapshot di istanze, rimuovi le informazioni sul sistema operativo e sull'app univoche per l'istanza generando l'immagine macchina da un'istanza. Ad esempio, per Windows VM utilizzare GCESysprep per preparare il sistema per la replica.

Console

1. Nella console Google Cloud, vai alla pagina Immagini macchina.

   Vai a Immagini macchina

2. Fai clic su Crea immagine macchina.

3. Specifica un nome per l'immagine della macchina.

4. (Facoltativo) Fornisci una descrizione.

5. Seleziona Istanza VM di origine.

6. (Facoltativo) Specifica dove archiviare l'immagine della macchina. Scegli tra Più regioni o Regional Storage. Per ulteriori informazioni sulla posizione, vedi Posizione di archiviazione delle immagini della macchina.

7. (Facoltativo) Seleziona un metodo di Crittografia.

8. Fai clic su Crea.

gcloud

Utilizza la 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:

• MACHINE_IMAGE_NAME: nome della macchina dell'immagine che desideri creare.
• SOURCE_VM_NAME: nome della fonte Istanza VM da cui vuoi creare l'immagine.

Esempio

Ad esempio, puoi utilizzare il seguente comando gcloud per creare una macchina immagine denominata my-machine-image da un'istanza di origine denominata my-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, ottieni 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 all'evento machineimages.insert . Nel corpo della richiesta, includi la seguente richiesta POST:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/machineImages

{
  "name": "MACHINE_IMAGE_NAME",
  "sourceInstance": "SOURCE_INSTANCE_URL"
}

Sostituisci quanto segue:

• PROJECT_ID: ID progetto.
• MACHINE_IMAGE_NAME: nome della macchina dell'immagine che desideri creare.

• SOURCE_INSTANCE_URL: URL completo o parziale di l'istanza VM di origine che vuoi utilizzare per creare l'immagine macchina. Ad esempio, se hai un'istanza di origine denominata my-instance in un progetto denominato myProject. 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

Passaggi successivi

• Scopri di più sulle immagini macchina
• Crea istanze VM da immagini macchina