Crea immagini macchina

Utilizza un'immagine macchina per archiviare configurazioni, metadati, autorizzazioni e dati provenienti da 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 come e quando utilizzare le immagini macchina, vedi l'apposita sezione.

Questo documento descrive i passaggi per creare un'immagine macchina da un'istanza VM di origine.

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 a servizi e API di Trusted Cloud by S3NS . 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 Trusted Cloud console to access Trusted Cloud by S3NS services and APIs, you don't need to set up authentication.

  gcloud

  1. Install the Google Cloud CLI, and then sign in to the gcloud CLI with your federated identity. After signing in, initialize the Google Cloud CLI by running the following command:

     gcloud init

  2. Set a default region and zone.

  REST

  Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, devi utilizzare le credenziali che fornisci a gcloud CLI.

  Install the Google Cloud CLI, and then sign in to the gcloud CLI with your federated identity. After signing in, initialize the Google Cloud CLI by running the following command:

  gcloud init

  Per saperne di più, consulta Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Trusted Cloud .

Limitazioni e restrizioni

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

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

  • hanno più di 200 TB di dischi collegati;
  • non hanno alcun disco collegato;
  • hanno volumi Hyperdisk collegati;
  • utilizzano un tipo di macchina C3D, H3, A4, A3 o Z3.

Proprietà di istanze e dischi non supportate dall'immagine macchina

Quando crei immagini macchina da istanze VM o viceversa, le seguenti proprietà di istanze e dischi non vengono conservate o ripristinate:

• 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

Puoi creare immagini macchina utilizzando la consoleTrusted Cloud , Google Cloud CLI o REST.

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

• Un nome per l'immagine 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
• Una storageLocation facoltativa. In assenza di specificazioni, 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 Google Cloud-powered encryption key, una chiave 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 Google Cloud-powered encryption key.

• Se vuoi utilizzare un'immagine macchina per la clonazione e gli snapshot delle istanze, prima di generare l'immagine macchina da un'istanza, rimuovi tutte le informazioni sulle app e sul sistema operativo univoche relative a quell'istanza. Ad esempio, per le istanze VM Windows, utilizza GCESysprep per preparare il sistema a eseguire una replica.

gcloud compute machine-images create MACHINE_IMAGE_NAME \
    --source-instance=SOURCE_VM_NAME

gcloud compute machine-images create my-machine-image  \
    --source-instance=my-instance

Created [https://www.googleapis.com/compute/v1/projects/project-12345/global/machineImages/my-machine-image].
NAME               STATUS
my-machine-image   READY

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

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

Passaggi successivi

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