Importa dischi virtuali

Console

Per importare un'immagine del disco virtuale in Compute Engine utilizzando la console Google Cloud , segui questi passaggi.

1. Apri la pagina Migrate to Virtual Machines nella console Google Cloud .
   Vai alla pagina Migrate to Virtual Machines
2. Seleziona la scheda Importazioni immagini.
3. Fai clic su Crea immagine.
4. Definisci le caratteristiche dell'immagine. La tabella seguente elenca i parametri che puoi impostare per l'immagine.

   Titolo della sezione	Nome campo	Descrizione
   Generali	Nome	Il nome dell'immagine che vuoi creare. Per ulteriori informazioni sulle regole di denominazione, consulta la convenzione di denominazione.
   	ID importazione immagine	Un ID che rappresenta la risorsa di importazione delle immagini. Quando importi un'immagine in Compute Engine, Migrate to Virtual Machines crea prima una risorsa di importazione dell'immagine. La risorsa di importazione dell'immagine rappresenta il processo di importazione dell'immagine. Puoi utilizzare l'ID importazione immagine per ottenere il link all'immagine importata.
   	File Cloud Storage di origine	Il file da cui vuoi importare l'immagine. Fai clic su Sfoglia per visualizzare l'elenco dei bucket nel progetto attuale e seleziona il file da cui vuoi importare l'immagine. Se vuoi importare un'immagine da un bucket di un altro progetto, devi inserire il percorso nel formato bucket/folder/file. Per visualizzare il percorso di un oggetto all'interno di un bucket, consulta Visualizza i metadati degli oggetti. Quando copi il percorso, assicurati di non copiare il prefisso gs://. Tieni presente che puoi importare immagini solo dai file .vmdk e .tar.gz.
   	Regione	La regione in cui vuoi creare l'immagine. Per un elenco delle regioni supportate, consulta Regioni e zone.
   	Progetto di destinazione	Il progetto di destinazione in cui vuoi creare l'immagine. Se non hai ancora aggiunto un progetto di destinazione, segui le istruzioni riportate in Aggiungi un progetto di destinazione.
   	Famiglia	(Facoltativo) Seleziona la famiglia di immagini. Compute Engine fornisce famiglie di immagini per fare in modo che i sistemi di automazione possano fare riferimento alle immagini più recenti. In qualità di amministratore, puoi raggruppare una serie di immagini in una famiglia. Per saperne di più, consulta Famiglie di immagini pubbliche.
   	Descrizione	(Facoltativo) Aggiungi una descrizione dell'immagine.
   	Salta adattamento del sistema operativo	Per saltare l'adattamento del sistema operativo, fai clic sul pulsante di attivazione/disattivazione Salta adattamento del sistema operativo in modo che sia impostato su On. Perché funzionino correttamente su Google Cloud, occorre modificare la configurazione delle VM create dalle immagini importate. Queste modifiche sono chiamate adattamenti del sistema operativo. Migrate to Virtual Machines esegue automaticamente gli adattamenti del sistema operativo durante la procedura di importazione dell'immagine. Per saperne di più, consulta Adatta le istanze VM per l'esecuzione su Google Cloud.
   	Generalizza	Per generalizzare l'immagine, fai clic sul pulsante di attivazione/disattivazione Generalizza in modo che sia impostato su On. Quando crei un'istanza da un'immagine, Windows aggiunge alcune informazioni univoche all'istanza. La generalizzazione è un processo che rimuove queste informazioni in modo da poter creare più istanze dalla stessa immagine.
   Licenze	Tipo di licenza	Compute Engine supporta le licenze con pagamento a consumo (PAYG) e BYOL (Bring Your Own License) per le VM di cui è stato eseguito il deployment. Il tipo di licenza predefinito per una VM di cui è stata eseguita la migrazione viene assegnato da Migrate to Virtual Machines in base al sistema operativo di cui è stata eseguita la migrazione, come descritto in Sistemi operativi supportati. Se il sistema operativo supporta più tipi di licenza, puoi sostituire il tipo di licenza predefinito per specificare esplicitamente un tipo di licenza PAYG o BYOL.
   Licenze aggiuntive	Licenze aggiuntive	Puoi aggiungere fino a 10 licenze aggiuntive all'istanza VM creata dall'immagine importata utilizzando un formato URL valido. Ad esempio, puoi aggiungere licenze aggiuntive utilizzando il seguente formato dell'URL: https://www.googleapis.com/compute/beta/projects/windows-sql-cloud/global/licenses/sql-server-2012-enterprise
   	Etichette	Per organizzare il progetto, aggiungi etichette alle risorse sotto forma di coppie chiave/valore. Consulta la sezione Organizzare le risorse utilizzando le etichette.
   Crittografia	Google-managed encryption key	Scegli questa opzione per utilizzare Google-owned and Google-managed encryption keys per criptare i dati durante la procedura di importazione. Per ulteriori informazioni, vedi Criptare i dati at-rest.
   	Chiave di crittografia gestita dal cliente	Scegli questa opzione per utilizzare le chiavi di crittografia gestite dal cliente (CMEK) per criptare i tuoi dati durante il processo di importazione e i dati dell'immagine creata dal processo di importazione. Se hai requisiti normativi o di conformità specifici relativi alle chiavi che proteggono i tuoi dati, puoi utilizzare CMEK per criptare e decriptare i tuoi dati. Queste chiavi di crittografia sono create, gestite da te e di tua proprietà. Per saperne di più, vedi Proteggi le risorse utilizzando le chiavi Cloud KMS. Quando aggiungi una CMEK, devi concedere le autorizzazioni come descritto nella tabella seguente. Ruolo Autorizzazioni obbligatorie Descrizione Service account VM Migration cloud roles/vmmigration.serviceAgen Concedi questa autorizzazione al account di servizio Compute Engine per criptare i dati dell'immagine creata durante il processo di importazione. Compute Engine Service Agent roles/compute.serviceAgent Concedi questa autorizzazione all'agente di servizio Migrate to Virtual Machines per criptare i dati durante il processo di importazione.

5. Seleziona Crea.

gcloud

Per importare un'immagine del disco virtuale in Compute Engine utilizzando Google Cloud CLI, utilizza la seguente richiesta.

gcloud migration vms image-imports create IMAGE_NAME \
--source-file=SOURCE_FILE \
--location=REGION_ID \
--target-project=projects/HOST_PROJECT_ID/locations/global/targetProjects/TARGET_PROJECT

Sostituisci quanto segue:

• IMAGE_NAME: il nome dell'immagine che vuoi creare. Per ulteriori informazioni sulle regole di denominazione, consulta la convenzione di denominazione.
• SOURCE_FILE: il file da cui vuoi importare l'immagine. Inserisci il percorso nel formato gs://bucket/folder/file. Per visualizzare il percorso di un oggetto all'interno di un bucket, consulta Visualizza i metadati degli oggetti. Tieni presente che puoi importare immagini solo dai file .vmdk e .tar.gz.
• REGION_ID: la regione in cui vuoi eseguire il processo di importazione dell'immagine. L'immagine viene creata nella multi-regione più vicina. Se vuoi che l'immagine venga creata in una regione, assicurati che singleRegionStorage sia impostato su true. Per un elenco delle regioni supportate, consulta Regioni e zone.
• HOST_PROJECT_ID: il nome del progetto host da cui vuoi eseguire la migrazione dell'immagine del disco virtuale.
• TARGET_PROJECT: il progetto di destinazione in cui vuoi creare l'immagine. Se non hai ancora aggiunto un progetto di destinazione, segui le istruzioni riportate in Aggiungi un progetto di destinazione.

Per ulteriori informazioni, vedi gcloud migration vms image-imports.

REST

Per importare un'immagine del disco virtuale in Compute Engine utilizzando l'API REST, segui questi passaggi.

1. Crea una risorsa di importazione dell'immagine utilizzando la seguente richiesta.

   POST https://vmmigration.googleapis.com/v1/projects/HOST_PROJECT_ID/locations/REGION_ID/imageImports?imageImportId=IMPORT_NAME
   {
   "cloudStorageUri": "SOURCE_FILE",
   "diskImageTargetDefaults": {
   "imageName": "IMAGE_NAME",
   "targetProject": "projects/HOST_PROJECT_ID/locations/global/targetProjects/TARGET_PROJECT",
   ...
   }
   }
   

   Sostituisci quanto segue:

   • HOST_PROJECT_ID: il nome del progetto host da cui vuoi eseguire la migrazione dell'immagine del disco virtuale.
   • REGION_ID: la regione in cui vuoi eseguire il processo di importazione dell'immagine. L'immagine viene creata nella multi-regione più vicina. Se vuoi che l'immagine venga creata in una regione, assicurati che singleRegionStorage sia impostato su true. Per un elenco delle regioni supportate, consulta Regioni e zone.
   • SOURCE_FILE: il file da cui vuoi importare l'immagine. Inserisci il percorso nel formato gs://bucket/folder/file. Per visualizzare il percorso di un oggetto all'interno di un bucket, consulta Visualizza i metadati degli oggetti. Tieni presente che puoi importare immagini solo dai file .vmdk e .tar.gz.
   • IMAGE_NAME: il nome dell'immagine che vuoi creare. Per ulteriori informazioni sulle regole di denominazione, consulta la convenzione di denominazione.
   • TARGET_PROJECT: il progetto di destinazione in cui vuoi creare l'immagine. Se non hai ancora aggiunto un progetto di destinazione, segui le istruzioni riportate in Aggiungi un progetto di destinazione.

   In questo esempio, IMPORT_NAME è un ID che rappresenta la risorsa di importazione dell'immagine. Quando importi un'immagine in Compute Engine, Migrate to Virtual Machines crea prima una risorsa di importazione dell'immagine. La risorsa di importazione dell'immagine rappresenta il processo di importazione dell'immagine. Puoi utilizzare IMPORT_NAME per ottenere il link all'immagine importata.

   Consulta la tabella seguente per l'elenco completo dei campi supportati della richiesta di creazione di importazione delle immagini.

   Nome campo	Descrizione
   cloudStorageUri	string Il percorso del file da cui vuoi importare l'immagine. Inserisci il percorso nel formato gs://bucket/folder/file. Per visualizzare il percorso di un oggetto all'interno di un bucket, consulta Visualizza i metadati degli oggetti. Tieni presente che puoi importare immagini solo dai file .vmdk e .tar.gz.
   diskImageTargetDefaults.targetProject	stringa Il percorso di TargetProject. Il progetto di destinazione in cui vuoi creare l'immagine. Per ulteriori informazioni, consulta il riferimento API del progetto di destinazione. Ad esempio, projects/HOST_PROJECT_ID/locations/global/targetProjects/TARGET_PROJECT Nell'esempio, sostituisci quanto segue: HOST_PROJECT_ID: il nome del progetto host da cui vuoi eseguire la migrazione dell'immagine del disco virtuale. TARGET_PROJECT: il progetto di destinazione in cui vuoi creare l'immagine.
   diskImageTargetDefaults.imageName	string Il nome dell'immagine da creare. Per ulteriori informazioni sulle regole di denominazione, consulta la convenzione di denominazione delle risorse.
   diskImageTargetDefaults.description	string (Facoltativo) Una descrizione dell'immagine.
   diskImageTargetDefaults.familyName	string (Facoltativo) Seleziona la famiglia di immagini. Compute Engine fornisce famiglie di immagini per fare in modo che i sistemi di automazione possano fare riferimento alle immagini più recenti. In qualità di amministratore, puoi raggruppare una serie di immagini in una famiglia. Per saperne di più, consulta Famiglie di immagini pubbliche. Per saperne di più, consulta Famiglie di immagini pubbliche.
   diskImageTargetDefaults.labels	map (key: string, value: string) Per organizzare il progetto, aggiungi etichette alle risorse sotto forma di coppie chiave/valore. Consulta la sezione Etichettatura delle risorse.
   diskImageTargetDefaults.additionalLicenses	string[] Puoi aggiungere fino a 10 licenze aggiuntive all'istanza VM creata dall'immagine importata utilizzando un formato URL valido. Ad esempio, puoi aggiungere licenze aggiuntive utilizzando il seguente formato dell'URL: https://www.googleapis.com/compute/beta/projects/windows-sql-cloud/global/licenses/sql-server-2012-enterprise
   diskImageTargetDefaults.singleRegionStorage	booleano Imposta questo flag su true se vuoi che l'immagine storageLocations sia una regione. Se imposti questo flag su false, viene selezionata la multi-regione più vicina.
   diskImageTargetDefaults.dataDiskImageImport	booleano Imposta questo flag su true se vuoi saltare l'adattamento del sistema operativo. Perché funzionino correttamente su Google Cloud, occorre modificare la configurazione delle VM create dalle immagini importate. Queste modifiche sono chiamate adattamenti del sistema operativo. Migrate to Virtual Machines esegue automaticamente gli adattamenti del sistema operativo durante la procedura di importazione dell'immagine. Per ulteriori informazioni, consulta Adatta le istanze VM per l'esecuzione su Google Cloud.
   diskImageTargetDefaults.osAdaptationParameters.licenseType	stringa Il tipo di licenza che vuoi utilizzare per l'immagine. Compute Engine supporta le licenze con pagamento a consumo (PAYG) e Bring Your Own License (BYOL) per le VM di cui è stato eseguito il deployment. Il tipo di licenza predefinito per una VM di cui è stata eseguita la migrazione viene assegnato da Migrate to Virtual Machines in base al sistema operativo di cui è stata eseguita la migrazione, come descritto in Sistemi operativi supportati. Se il sistema operativo supporta più tipi di licenza, puoi sostituire il tipo di licenza predefinito per specificare esplicitamente un tipo di licenza PAYG o BYOL.
   diskImageTargetDefaults.osAdaptationParameters.generalize	booleano Imposta questo flag su true se vuoi generalizzare l'immagine. Quando crei un'istanza da un'immagine, Windows aggiunge alcune informazioni univoche all'istanza. La generalizzazione è un processo che rimuove queste informazioni in modo da poter creare più istanze dalla stessa immagine.
   diskImageTargetDefaults.encryption	stringa La Google-owned and Google-managed encryption key che vuoi utilizzare per criptare i tuoi dati durante la procedura di importazione. Per ulteriori informazioni, vedi crittografa i dati quando sono at-rest.
   encryption	stringa Scegli questa opzione per utilizzare le chiavi di crittografia gestite dal cliente (CMEK) per criptare i tuoi dati durante la procedura di importazione e i dati dell'immagine creata durante la procedura di importazione. Se hai requisiti normativi o di conformità specifici relativi alle chiavi che proteggono i tuoi dati, puoi utilizzare CMEK per criptare e decriptare i tuoi dati. Queste chiavi di crittografia sono create, gestite da te e di tua proprietà. Per ulteriori informazioni, consulta Proteggi le risorse utilizzando le chiavi Cloud KMS. Quando aggiungi una CMEK, devi concedere le autorizzazioni come descritto nella tabella seguente. Ruolo Autorizzazioni obbligatorie Descrizione Service account VM Migration cloud roles/vmmigration.serviceAgent Concedi questa autorizzazione al account di servizio Compute Engine per criptare i dati dell'immagine creata durante il processo di importazione. Compute Engine Service Agent roles/compute.serviceAgent Concedi questa autorizzazione all'agente di servizio Migrate to Virtual Machines per criptare i dati durante il processo di importazione.

   Dovresti visualizzare una risposta simile alla seguente risposta di esempio.

   {
     "name": "projects/HOST_PROJECT_ID/locations/REGION_ID/operations/OPERATION_ID",
     "metadata": {
       "createTime": "2023-10-31T09:12:26.94928636Z",
       "target": "projects/HOST_PROJECT_ID/locations/us-central1/imageImports/IMPORT_NAME",
       "verb": "create",
       "apiVersion": "v1",
       "@type": "type.googleapis.com/google.cloud.vmmigration.v1.OperationMetadata"
     }
   }
   

2. Controlla se il job di importazione dell'immagine è stato completato eseguendo il polling dell'operazione utilizzando il seguente comando.

   GET https://vmmigration.googleapis.com/v1/projects/HOST_PROJECT_ID/locations/REGION_ID/operations/OPERATION_ID
   

   Sostituisci quanto segue:

   • HOST_PROJECT_ID: il nome del progetto host da cui esegui la migrazione dell'immagine del disco virtuale.
   • REGION_ID: la regione in cui vuoi eseguire il processo di importazione dell'immagine. L'immagine viene creata nella multi-regione più vicina. Se vuoi che l'immagine venga creata in una regione, assicurati che singleRegionStorage sia impostato su true. Per un elenco delle regioni supportate, consulta Regioni e zone.
   • OPERATION_ID: l'ID operazione del job di migrazione.

   Dovresti visualizzare una risposta di completamento dell'operazione simile alla seguente risposta di esempio.

     {
       "done": true,
       "name": "projects/HOST_PROJECT_ID/locations/REGION_ID/operations/OPERATION_ID",
       "response": {
         "@type": "type.googleapis.com/google.cloud.vmmigration.v1.ImageImport",
         "name": "projects/<HOST_PROJECT_ID>/locations/us-central1/imageImports/IMPORT_NAME",
         "cloudStorageUri": "SOURCE_FILE",
         "createTime": "2023-10-31T09:04:04.413664947Z",
         "diskImageTargetDefaults": {
           "imageName": "IMAGE_NAME",
           "targetProject": "projects/HOST_PROJECT_ID/locations/global/targetProjects/TARGET_PROJECT"
         },
         "recentImageImportJobs": [
           {
             "name": "projects/HOST_PROJECT_ID/locations/us-central1/imageImports/IMPORT_NAME/imageImportJobs/image-import-job",
             "diskImageTargetDetails": {
              "imageName": "IMAGE_NAME",
              "targetProject": "projects/HOST_PROJECT_ID/locations/global/targetProjects/TARGET_PROJECT"
           },
            "state": "PENDING"
          }
         ]
       },
       "metadata": {
         "createTime": "2023-10-31T09:04:04.416740716Z",
         "endTime": "2023-10-31T09:05:36.79987142Z",
         "target": "projects/HOST_PROJECT_ID/locations/us-central1/imageImports/IMPORT_NAME",
         "verb": "create",
         "apiVersion": "v1",
         "@type": "type.googleapis.com/google.cloud.vmmigration.v1.OperationMetadata"
       }
     }
   

3. Monitora il completamento del job di importazione dell'immagine utilizzando il seguente comando.

   GET https://vmmigration.googleapis.com/v1/projects/HOST_PROJECT_ID/locations/REGION_ID/imageImports/IMPORT_NAME/imageImportJobs/image-import-job
   

   Sostituisci quanto segue:

   • HOST_PROJECT_ID: il nome del progetto host da cui esegui la migrazione dell'immagine del disco virtuale.
   • REGION_ID: la regione in cui vuoi eseguire il processo di importazione dell'immagine. L'immagine viene creata nella multi-regione più vicina. Se vuoi che l'immagine venga creata in una regione, assicurati che singleRegionStorage sia impostato su true. Per un elenco delle regioni supportate, consulta Regioni e zone.
   • IMPORT_NAME: l'ID che rappresenta la risorsa di importazione delle immagini. Quando importi un'immagine in Compute Engine, Migrate to Virtual Machines crea prima una risorsa di importazione dell'immagine. La risorsa di importazione dell'immagine rappresenta il processo di importazione dell'immagine. Puoi utilizzare IMPORT_NAME per ottenere il link all'immagine importata.

   Dovresti visualizzare una risposta di completamento del job simile alla seguente risposta di esempio.

   {
     "createTime":"2023-10-31T09:12:27.053788394Z",
     "createdResources":[
       "https://www.googleapis.com/compute/v1/projects/USER_PROJECT/global/images/IMAGE_NAME"
     ],
     "diskImageTargetDetails": {
       "imageName":"IMAGE_NAME",
       "targetProject":"projects/HOST_PROJECT_ID/locations/global/targetProjects/TARGET_PROJECT"
     },
     "endTime":"2023-10-31T09:16:50.224865783Z",
     "name":"projects/HOST_PROJECT_ID/locations/us-central1/imageImports/IMPORT_NAME/imageImportJobs/image-import-job",
     "state":"SUCCEEDED"
   }