Importa ed esporta le VM

La funzionalità di importazione ed esportazione di Migrate to Virtual Machines ti consente di creare, esportare e rivedere le VM di cui è in corso la migrazione 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 gruppi di VM. Gli stessi prerequisiti si applicano alla gestione delle migrazioni tramite CSV.

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

• Esegui 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 che descriva le VM di origine o le VM attuali e i relativi dettagli di destinazione, modificarli esternamente e poi 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 la procedura di importazione creerà migrazioni e gruppi, modificherà le iscrizioni ai gruppi e aggiornerà i dettagli del target in modo che corrispondano allo stato del file CSV importato.

Per definire un file CSV per la procedura di importazione, hai a disposizione diverse opzioni:

• Esporta i dettagli della migrazione esistenti come file CSV per l'editing collettivo e i caricamenti collettivi
• Esportare le VM di origine da un inventario di origine come file CSV
• Scaricare e modificare un file CSV modello

Se il file CSV non è formattato correttamente o un dettaglio specifico della migrazione non è valido, riceverai un messaggio di errore durante il caricamento in Migrate to Virtual Machines.

Nota: non puoi eliminare i gruppi o le VM di cui è in corso la migrazione utilizzando la funzionalità di importazione e 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 dell'origine, regione di origine e nome visualizzato della VM di origine o ID VM di origine.
• La stessa migrazione o VM di origine non può essere presente in più di una riga.
• Non è possibile elaborare più di 100 migrazioni o VM di origine in un unico file.
• Se non esiste una migrazione per la VM di origine, l'esistenza della VM di origine viene convalidata e viene creata una nuova migrazione.
• La funzionalità di migrazione di importazione ed esportazione convalida le colonne dei dettagli della destinazione in base al tipo e alle limitazioni di denominazione delle risorse. Per evitare errori, devi convalidare manualmente l'esistenza delle risorse nel progetto di destinazione.
• Le colonne mancanti nel file CSV verranno ignorate e le migrazioni non verranno aggiornate in questi campi. Tuttavia, i valori vuoti aggiorneranno la rispettiva migrazione e rimuoveranno i dati da questa.
• Le colonne possono contenere più valori per VM (ad esempio tag di rete o etichette), separati da interruzioni di riga. Per un esempio, consulta Esportare un file modello.

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

Nota: gli avvisi a livello di riga possono essere ignorati a discrezione dell'utente. Seleziona Ignora gli errori e continua nella pagina di importazione per andare avanti.

Campi dei file CSV

È obbligatoria 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 esistono al momento dell'importazione. Le colonne di intestazione sconosciute verranno ignorate.

I campi obbligatori per il file CSV includono:

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

Per ulteriori informazioni sui campi facoltativi, consulta la sezione sulla configurazione della destinazione per una VM di cui è stata eseguita la migrazione.

Nota: i valori dei metadati possono essere molto lunghi e contenere interruzioni di riga. La procedura di esportazione e importazione supporta solo valori semplici di una riga. Se la migrazione contiene valori dei metadati non supportati, il file CSV verrà oscurato durante l'esportazione. L'importazione di nuovo dello stesso file CSV ignorerà le colonne dei metadati oscurati.

File modello

Puoi esportare un file modello per aiutarti a definire il file CSV. Il file CSV del modello è vuoto, tranne per una riga di intestazione che descrive i campi obbligatori e facoltativi e una riga di esempio che fornisce esempi di come formattare ogni colonna. Nel modello, i dettagli del target sono rappresentati dalle colonne del file CSV.

Nota: la riga delle intestazioni fornita dal modello è obbligatoria per un'importazione riuscita.

Esportare un file CSV precompilato

Per creare migrazioni in base alle 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:

1. Apri la pagina Esegui la migrazione a Virtual Machines 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 Gruppi.
   2. Seleziona i gruppi da 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, vengono visualizzati e puoi scegliere di ignorarle e importare le altre.

Dopo aver caricato un file CSV convalidato, ti verrà presentato un piano di importazione da approvare. Il file verrà importato al momento dell'approvazione.

Per importare il file CSV, segui questi passaggi:

1. Apri la pagina Esegui la migrazione a Virtual Machines nella console Google Cloud.
2. Seleziona la scheda Gruppi, quindi Importa.

3. Cerca il file di importazione. Deve essere un file CSV di dimensioni massime pari a 100 kB.

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

4. Seleziona Carica.

   Se sono presenti errori, ti verranno mostrati in questo passaggio. Puoi scegliere di Ignora gli errori e continua.

5. A questo punto, visualizzerai un piano di importazione. Verranno descritti in dettaglio 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 a essere completata, esamina i messaggi di errore forniti. L'errore di un passaggio interrompe l'intera sequenza.

8. Al termine dell'importazione, seleziona Vai ai 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 della procedura di importazione (in cui il file CSV rappresenta lo stato ideale delle migrazioni), la procedura di migrazione di importazione ed esportazione salterà le azioni già completate e continuerà da dove si è verificata l'interruzione.

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:

• Creare migrazioni.
• Crea un gruppo.
• Rimuovi le migrazioni da un gruppo.
• Aggiungere migrazioni a un gruppo.
• Aggiorna i dettagli della destinazione per le migrazioni.

Una volta accettato il piano di importazione, lo stato di ogni elemento verrà aggiornato man mano che l'importazione procede. Nel report potrai vedere lo stato, ad esempio In sospeso, In esecuzione, Completato e Non riuscito, in relazione a ciascun articolo.

Esportare il file del modello di migrazione

Puoi esportare un file modello di migrazione per informazioni dettagliate sulla formattazione corretta del file CSV.

Per esportare il file del modello di migrazione:

1. Apri la pagina Esegui la migrazione a Virtual Machines nella console Google Cloud.
2. Seleziona la scheda Gruppi.
3. Seleziona Importa.
4. Seleziona Esporta modello e ti verrà chiesto di scaricare il file Template.csv.