Importa ed esporta le VM

La funzionalità di importazione ed esportazione di Migrate to Virtual Machines consente di creare, esportare e rivedere la migrazione delle VM utilizzando un file CSV.

Prerequisiti per la migrazione

Prima di utilizzare la funzionalità di importazione ed esportazione, devi esaminare i prerequisiti per la migrazione di singole VM o di gruppi di VM. Quando si gestiscono le migrazioni tramite CSV, si applicano gli stessi prerequisiti.

Per ulteriori informazioni sulle migrazioni, consulta la documentazione di Migrate to Virtual Machines su:

• Eseguire la migrazione di singole VM
• Eseguire la migrazione dei gruppi di VM

Panoramica di importazione ed esportazione

Puoi utilizzare la funzionalità di esportazione per generare un file CSV con i dettagli delle VM di origine o delle VM attuali e i relativi dettagli di destinazione, modificarle esternamente e quindi caricare il file CSV in Migrate to Virtual Machines per definire le migrazioni.

Quando modifichi e importi il file CSV, tieni presente lo stato finale della migrazione. In altre parole, puoi definire le impostazioni nel file CSV e il processo di importazione creerà migrazioni e gruppi, modificherà le iscrizioni ai gruppi e aggiornerà i dettagli della destinazione in modo che corrispondano allo stato del file CSV importato.

Per definire un file CSV per il processo di importazione, hai a disposizione diverse opzioni:

• Esportare i dettagli esistenti sulla migrazione come file CSV per la modifica collettiva e i caricamenti di gruppo
• Esporta le VM di origine da un inventario di origine come file CSV
• Scaricare e modificare un modello di file CSV

Se il formato del file CSV non è corretto o un dettaglio specifico della migrazione non è valido, riceverai un errore durante il caricamento su Migrate to Virtual Machines.

Nota: non puoi eliminare i gruppi o le VM di migrazione utilizzando la funzionalità di importazione ed esportazione.

Formato del file CSV

Prima di eseguire qualsiasi azione, il file CSV importato verrà analizzato e convalidato in base ai seguenti criteri:

• Le migrazioni e le VM di origine verranno identificate come una combinazione di nome origine, regione di origine e nome visualizzato della VM di origine o ID VM di origine.
• La stessa VM di origine o di migrazione non può essere visualizzata in più di una riga.
• Non è possibile elaborare più di 100 migrazioni o VM di origine in un singolo file.
• Se non esiste una migrazione per la VM di origine, l'esistenza della VM di origine viene convalidata e ne verrà creata una nuova migrazione.
• La funzionalità di importazione ed esportazione della migrazione convalida le colonne dei dettagli della destinazione in base al tipo e alle limitazioni di denominazione delle risorse. Devi convalidare manualmente l'esistenza di risorse nel progetto di destinazione per evitare errori.
• Le colonne mancanti nel file CSV verranno ignorate e le migrazioni non verranno aggiornate in questi campi. Tuttavia, i valori vuoti aggiorneranno la migrazione corrispondente e rimuoveranno i dati da quella migrazione.
• Le colonne possono contenere più valori per VM (ad esempio etichette o tag di rete), separati da interruzioni di riga. Per un esempio, consulta Esportazione di un file modello.

Alcuni errori di convalida bloccheranno la continuazione dell'importazione. Ad esempio, una riga di intestazione non valida o un file con troppe righe generano un errore di convalida.

Nota: gli avvisi a livello di riga possono essere ignorati a tua discrezione. Seleziona Ignora gli errori e continua nella pagina di importazione per continuare.

Campi del file CSV

È prevista una riga di intestazione che deve contenere le seguenti colonne che identificano la migrazione o la VM di origine. Le altre colonne sono facoltative e verranno aggiornate solo se sono state importate. Le colonne di intestazione sconosciute verranno ignorate.

I campi obbligatori del file CSV includono:

• Nome origine
• Regione
• Nome visualizzato della VM di origine o ID VM di origine

Per saperne di più sui campi facoltativi, vedi Configurare la destinazione per una VM di cui è stata eseguita la migrazione.

Nota :i valori dei metadati possono essere molto lunghi e contenere freni di linea. Il processo di esportazione e importazione supporta solo valori semplici di una riga. Se la migrazione contiene valori di metadati non supportati, il file CSV verrà oscurato durante l'esportazione. Se reimporti lo stesso file CSV, le colonne dei metadati oscurate verranno ignorate.

File modello

Puoi esportare un file modello che ti aiuti a definire il file CSV. Il file CSV del modello è vuoto, tranne che per una riga di intestazione che descrive nel dettaglio i campi obbligatori e facoltativi e una riga di esempio che fornisce esempi di formattazione di ogni colonna. Nel modello, i dettagli della destinazione sono rappresentati dalle colonne del file CSV.

Nota: la riga delle intestazioni fornita dal modello è necessaria per una corretta importazione.

Esportare un file CSV precompilato

Per creare migrazioni basate sulle VM di origine o per apportare modifiche a una migrazione o a un gruppo di migrazioni esistenti, devi prima esportare un file CSV che rappresenti lo stato attuale delle migrazioni.

Per esportare un file CSV precompilato, segui questi passaggi:

1. Apri la pagina Esegui la migrazione alle macchine virtuali nella console Google Cloud.

2. Per esportare un elenco di VM di origine:

   1. Seleziona la scheda Origini.
   2. Seleziona le VM di origine che vuoi esportare dall'inventario.
   3. Fai clic su Esporta per scaricare il file CSV.

3. Per esportare gruppi di migrazioni esistenti:

   1. Seleziona la scheda Groups (Gruppi).
   2. Seleziona i gruppi che vuoi esportare dall'elenco dei gruppi.
   3. Fai clic su Esporta per scaricare il file CSV.

Importa il file CSV

Quando carichi un file CSV, questo viene convalidato. Se alcune righe del file contengono errori, questi vengono visualizzati e puoi scegliere di saltare queste righe e importare le altre.

Quando carichi un file CSV convalidato, verrà presentato un piano di importazione da approvare. Il file verrà importato al momento dell'approvazione.

Per importare il file CSV:

1. Apri la pagina Esegui la migrazione alle macchine virtuali nella console Google Cloud.
2. Seleziona la scheda Groups (Gruppi), quindi Import (Importa).

3. Cerca il file di importazione. Deve essere un file CSV di massimo 100 kB.

   Suggerimento: non puoi caricare un file CSV mentre è già in corso un'altra importazione.

4. Seleziona Carica.

   In caso di errori, ti verranno presentati in questo passaggio. Puoi scegliere l'opzione Salta gli errori e continua.

5. Ti verrà presentato un piano di importazione. In questo modo verranno indicate le azioni richiamate e le risorse a cui viene fatto riferimento.

6. Seleziona Avvia importazione per approvare il piano di importazione e iniziare l'importazione. Il piano di importazione verrà aggiornato con l'avanzamento di ogni passaggio.

7. Se l'importazione non riesce, esamina i messaggi di errore forniti. L'errore di un passaggio qualsiasi comporta l'interruzione dell'intera sequenza.

8. Se l'importazione è riuscita, seleziona Vai a gruppi per tornare alla pagina Gruppi ed esaminare le risorse aggiornate.

   Nota: in caso di errore, puoi riprovare a importare lo stesso file CSV. Data la natura del processo di importazione (in cui il file CSV rappresenta lo stato ideale delle migrazioni), il processo di importazione ed esportazione ignorerà le azioni già completate e riprenderà da dove non è riuscita.

Rivedi il piano di importazione

Un piano di importazione è un elenco di azioni generate in base alle modifiche rilevate nel file di importazione. Potrebbero essere elencati i seguenti tipi di messaggi:

• Crea migrazioni.
• Crea un gruppo.
• Rimuovere le migrazioni da un gruppo.
• Aggiungi migrazioni a un gruppo.
• Aggiorna i dettagli della destinazione per le migrazioni.

Dopo aver accettato il piano di importazione, lo stato di ogni elemento viene aggiornato man mano che l'importazione progredisce. Nel report potrai visualizzare lo stato, ad esempio In attesa, In esecuzione, Completato e Non riuscito, in quanto è correlato a ciascun elemento.

Esportare il file del modello di migrazione

Puoi esportare un file del modello di migrazione per maggiori dettagli sulla corretta formattazione del file CSV.

Per esportare il file del modello di migrazione:

1. Apri la pagina Esegui la migrazione alle macchine virtuali nella console Google Cloud.
2. Seleziona la scheda Groups (Gruppi).
3. Seleziona Importa.
4. Seleziona Esporta modello e ti verrà chiesto di scaricare il file Template.csv.