VMs importieren und exportieren

Mit der Import- und Exportfunktion von Migrate to Virtual Machines können Sie migrierende VMs mithilfe einer CSV-Datei erstellen, exportieren und überarbeiten.

Voraussetzungen für die Migration

Bevor Sie die Import- und Exportfunktion verwenden, sollten Sie die Voraussetzungen für die Migration einzelner VMs oder Gruppen von VMs prüfen. Dieselben Voraussetzungen gelten auch, wenn Sie Migrationen über CSV verwalten.

Weitere Informationen zu Migrationen finden Sie in der Dokumentation zu Migrate to Virtual Machines unter:

• Einzelne VMs migrieren
• VM-Gruppen migrieren

Import- und Exportübersicht

Mit der Exportfunktion können Sie eine CSV-Datei mit den Quell-VMs oder den aktuellen VMs und deren Zieldetails ausgeben, diese extern bearbeiten und die CSV-Datei in Migrate to Virtual Machines hochladen, um die Migrationen zu definieren.

Wenn Sie die CSV-Datei bearbeiten und importieren, sollten Sie den Endstatus Ihrer Migration berücksichtigen. Sie können also die gewünschten Einstellungen in Ihrer CSV-Datei definieren. Der Importvorgang erstellt dann die Migrationen und Gruppen, ändert die Gruppenmitgliedschaften und aktualisiert die Zieldetails so, dass sie dem Status der importierten CSV-Datei entsprechen.

Es gibt mehrere Möglichkeiten, eine CSV-Datei für den Importvorgang zu definieren:

• Vorhandene Migrationsdetails als CSV-Datei für die Bulk-Bearbeitung und Gruppenuploads exportieren.
• Quell-VMs aus einem Quellinventar als CSV-Datei exportieren.
• Vorlagen-CSV-Datei herunterladen und bearbeiten.

Wenn Ihre CSV-Datei falsch formatiert ist oder ein bestimmtes Migrationsdetails ungültig ist, wird beim Hochladen auf Migrate to Virtual Machines eine Fehlermeldung angezeigt.

Hinweis: Sie können Ihre Gruppen oder Ihre migrierenden VMs nicht mit der Import- und Exportfunktion löschen.

CSV-Dateiformat

Bevor eine der Aktionen ausgeführt wird, wird die importierte CSV-Datei nach den folgenden Kriterien geparst und validiert:

• Migrationen und Quell-VMs werden als eine Kombination aus Quellname, Quellregion und entweder dem Quell-VM-Anzeigenamen oder dem Quell-VM-ID identifiziert.
• Dieselbe Migration oder Quell-VM kann nicht in mehr als einer Zeile angezeigt werden.
• In einer einzelnen Datei können maximal 100 Migrationen oder Quell-VMs verarbeitet werden.
• Wenn für die Quell-VM keine Migration vorhanden ist, wird das Vorhandensein der Quell-VM validiert und für sie wird eine neue Migration erstellt.
• Bei der Import- und Exportmigrationsfunktion werden Zieldetailspalten nach den Einschränkungen für den Typ und die Ressourcenbenennung validiert. Sie sollten das Vorhandensein von Ressourcen in Ihrem Zielprojekt manuell validieren, um Fehler zu vermeiden.
• Fehlende Spalten in der CSV-Datei werden ignoriert und Migrationen werden in diesen Feldern nicht aktualisiert. Leere Werte aktualisieren jedoch die entsprechende Migration und entfernen Daten aus dieser Migration.
• Spalten können mehrere Werte pro VM enthalten (z. B. Netzwerk-Tags oder Labels), die durch Zeilenumbrüche getrennt sind. Ein Beispiel finden Sie unter Vorlagendatei exportieren.

Einige Validierungsfehler blockieren die Fortsetzung des Imports. Beispielsweise gibt eine ungültige Headerzeile oder eine Datei mit zu vielen Zeilen einen Validierungsfehler aus.

Hinweis: Warnungen auf Zeilenebene können nach eigenem Ermessen ignoriert werden. Wählen Sie auf der Importseite Fehler überspringen und fortfahren aus, um fortzufahren.

CSV-Dateifelder

Eine Headerzeile wird erwartet und muss die folgenden Spalten zur Identifizierung der Migration oder Quell-VM enthalten. Andere Spalten sind optional und werden nur beim Importieren aktualisiert, wenn sie vorhanden sind. Unbekannte Headerspalten werden ignoriert.

Pflichtfelder für Ihre CSV-Datei:

• Name der Quelle
• Region
• Entweder Anzeigename der Quell-VM oder Quell-VM-ID

Weitere Informationen zu optionalen Feldern finden Sie unter Ziel für eine migrierte VM konfigurieren.

Hinweis: Metadatenwerte können sehr lang sein und Zeilenbremsen enthalten. Der Export- und Importprozess unterstützt nur einfache einzeilige Werte. Wenn Ihre Migration nicht unterstützte Metadatenwerte enthält, wird die CSV-Datei beim Exportieren redigiert. Beim erneuten Importieren derselben CSV-Datei werden redigierte Metadatenspalten ignoriert.

Vorlagendateien

Sie können eine Vorlagendatei exportieren, um Ihre CSV-Datei zu definieren. Die CSV-Vorlagendatei ist leer, mit Ausnahme einer Headerzeile, in der die Pflichtfelder und optionalen Felder aufgeführt sind, und eine Beispielzeile, die Beispiele für die Formatierung jeder Spalte enthält. In der Vorlage werden Zieldetails durch die Spalten der CSV-Datei dargestellt.

Hinweis: Für einen erfolgreichen Import ist die von der Vorlage bereitgestellte Headerzeile erforderlich.

Vorausgefüllte CSV-Datei exportieren

Wenn Sie Migrationen anhand von Quell-VMs erstellen oder Änderungen an einer vorhandenen Migration oder Gruppe von Migrationen vornehmen möchten, sollten Sie zuerst eine CSV-Datei exportieren, die den aktuellen Status Ihrer Migrationen darstellt.

So exportieren Sie eine vorausgefüllte CSV-Datei:

1. Öffnen Sie in der Cloud Console die Seite Migrate to Virtual Machines:

2. So exportieren Sie eine Liste der Quell-VMs:

   1. Wählen Sie den Tab Quellen aus.
   2. Wählen Sie die Quell-VMs aus, die Sie aus dem Inventar exportieren möchten.
   3. Klicken Sie auf Exportieren, um die CSV-Datei herunterzuladen.

3. So exportieren Sie Gruppen vorhandener Migrationen:

   1. Wählen Sie den Tab Gruppen aus.
   2. Wählen Sie aus der Gruppenliste die Gruppen aus, die Sie exportieren möchten.
   3. Klicken Sie auf Exportieren, um die CSV-Datei herunterzuladen.

CSV-Datei importieren

Wenn Sie eine CSV-Datei hochladen, wird sie validiert. Wenn einige Zeilen in der Datei Fehler enthalten, werden diese angezeigt und Sie können diese Zeilen überspringen und den Rest importieren.

Nach dem Hochladen einer validierten CSV-Datei wird ein Importplan zur Genehmigung angezeigt. Ihre Datei wird nach der Genehmigung importiert.

So importieren Sie die CSV-Datei:

1. Öffnen Sie in der Cloud Console die Seite Migrate to Virtual Machines.
2. Wählen Sie den Tab Gruppen und dann Importieren aus.

3. Suchen Sie nach Ihrer Importdatei. Es muss sich um eine CSV-Datei handeln. Sie darf höchstens 100 KB groß sein.

   Tipp: Sie können keine CSV-Datei hochladen, während bereits ein anderer Import läuft.

4. Wählen Sie Hochladen aus.

   Falls Fehler vorliegen, werden diese in diesem Schritt angezeigt. Sie können Fehler überspringen und fortfahren auswählen.

5. Ihnen wird dann ein Importplan angezeigt. Dadurch wird angegeben, welche Aktionen aufgerufen und auf welche Ressourcen verwiesen wird.

6. Wählen Sie Import starten aus, um den Importplan zu genehmigen und den Import zu starten. Der Importplan wird mit dem Fortschritt jedes Schritts aktualisiert.

7. Wenn der Import fehlgeschlagen ist, prüfen Sie die angegebenen Fehlermeldungen. Wenn in einem Schritt ein Fehler auftritt, wird die gesamte Sequenz beendet.

8. Wählen Sie bei einem erfolgreichen Import Zu Gruppen aus, um zur Seite Gruppen zurückzukehren und Ihre aktualisierten Ressourcen zu prüfen.

   Hinweis: Wenn ein Fehler auftritt, können Sie versuchen, dieselbe CSV-Datei zu importieren. Je nach Art des Importvorgangs, in dem die CSV-Datei den idealen Status Ihrer Migrationen darstellt, überspringt der Import- und Exportmigrationsprozess bereits abgeschlossene Aktionen und wird an dem Punkt fortgesetzt, an dem er fehlgeschlagen ist.

Importplan überprüfen

Ein Importplan ist eine Liste von Aktionen, die gemäß den in Ihrer Importdatei erkannten Änderungen generiert wurde. Die folgenden Nachrichtentypen können aufgeführt werden:

• Migrationen erstellen.
• Gruppe erstellen.
• Migrationen aus einer Gruppe entfernen.
• Migrationen einer Gruppe hinzufügen.
• Zieldetails für Migrationen aktualisieren.

Nach Annahme des Importplans wird der Status jedes Elements im Verlauf des Imports aktualisiert. Im Bericht werden die Status wie Ausstehend, Wird ausgeführt, Fertig und Fehlgeschlagen zusammen mit den betreffenden Elementen angezeigt.

Migrationsvorlagendatei exportieren

Sie können eine Migrationsvorlagendatei exportieren, um Details zur korrekten Formatierung Ihrer CSV-Datei zu erhalten.

So exportieren Sie die Migrationsvorlagendatei:

1. Öffnen Sie in der Cloud Console die Seite Migrate to Virtual Machines:
2. Wählen Sie den Tab Gruppen aus.
3. Wählen Sie Importieren aus.
4. Wählen Sie Vorlage exportieren aus. Sie werden dann aufgefordert, die Datei Template.csv herunterzuladen.