Importer et exporter des VM

La fonctionnalité d'importation et d'exportation de Migrate to Virtual Machines vous permet de créer, d'exporter et de modifier des VM à l'aide d'un fichier CSV.

Conditions préalables à la migration

Avant d'utiliser la fonctionnalité d'importation et d'exportation, vous devez vérifier les conditions préalables à la migration de VM uniques et de groupes de VM. Les mêmes conditions préalables s'appliquent lors de la gestion de migrations au format CSV.

Pour en savoir plus sur les migrations, consultez la documentation sur Migrate to Virtual Machines sur :

• Migrer des VM individuelles
• Migrer des groupes de VM

Présentation de l'importation et de l'exportation

Vous pouvez utiliser la fonctionnalité d'exportation pour générer un fichier CSV qui détaille vos VM sources ou vos VM actuelles et leurs détails cible, les modifier en externe, puis importer le fichier CSV dans Migrate to Virtual Machines afin de définir vos migrations.

Lorsque vous modifiez et importez votre fichier CSV, n'oubliez pas l'état final de votre migration. En d'autres termes, vous pouvez définir vos paramètres dans votre fichier CSV. Le processus d'importation crée des migrations et des groupes, modifie les appartenances aux groupes et met à jour les détails de la cible afin qu'ils correspondent à l'état du fichier CSV importé.

Pour définir un fichier CSV pour le processus d'importation, vous disposez de plusieurs options :

• Exporter vos détails de migration existants sous forme de fichier CSV pour les modifier de manière groupée et les importer en groupe.
• Exporter des VM sources à partir d'un inventaire source sous forme de fichier CSV.
• Télécharger et modifier un modèle de fichier CSV.

Si le format de votre fichier CSV est incorrect ou si des détails de migration spécifiques ne sont pas valides, vous recevrez un message d'erreur lors de l'importation vers Migrate to Virtual Machines.

Remarque : Vous ne pouvez pas supprimer vos groupes ou vos VM de migration à l'aide de la fonctionnalité d'importation et d'exportation.

Format des fichiers CSV

Avant d'effectuer toute action, le fichier CSV importé sera analysé et validé en fonction des critères suivants :

• Les migrations et les VM sources sont identifiées comme une combinaison de nom de la source, région source et nom à afficher de la VM source ou ID de la VM source.
• La même migration ou VM source ne peut pas apparaître sur plusieurs lignes.
• Un fichier ne peut pas contenir plus de 100 migrations ou VM sources.
• Si aucune migration n'existe pour la VM source, l'existence de la VM source est validée et une nouvelle migration est créée pour celle-ci.
• La fonctionnalité de migration d'importation et d'exportation valide les colonnes de détails de la cible en fonction de leur type et de leurs restrictions de nommage de ressources. Vous devez valider manuellement l'existence des ressources dans votre projet cible afin d'éviter tout échec.
• Les colonnes manquantes dans le fichier CSV seront ignorées et les migrations ne seront pas mises à jour dans ces champs. Toutefois, les valeurs vides mettront à jour la migration correspondante et supprimeront les données de cette migration.
• Les colonnes peuvent contenir plusieurs valeurs par VM (telles que des tags réseau ou des libellés), séparées par des sauts de ligne. Reportez-vous à la section Exporter un fichier de modèle pour obtenir un exemple.

Certaines erreurs de validation empêchent la poursuite de l'importation. Par exemple, une ligne d'en-tête non valide ou un fichier comportant trop de lignes généreront une erreur de validation.

Remarque : Si vous le souhaitez, vous pouvez ignorer les avertissements au niveau des lignes. Sélectionnez Ignorer les erreurs et continuer sur la page d'importation pour continuer.

Champs du fichier CSV

Une ligne d'en-tête est attendue et doit contenir les colonnes suivantes identifiant la VM source ou la migration. Les autres colonnes sont facultatives et ne seront mises à jour qu'au moment de leur importation si elles existent. Les colonnes d'en-tête inconnues seront ignorées.

Les champs obligatoires pour votre fichier CSV incluent :

• Nom de la source
• Région
• Soit le nom à afficher de la VM source, soit l'ID de la VM source.

Pour en savoir plus sur les champs facultatifs, consultez la section Configurer la cible pour une VM migrée.

Remarque : Les valeurs de métadonnées peuvent être très longues et contenir des sauts de ligne. Le processus d'exportation et d'importation n'accepte que les valeurs simples sur une ligne. Si votre migration contient des valeurs de métadonnées non compatibles, votre fichier CSV sera masqué lors de l'exportation. Si vous importez le même fichier CSV, les colonnes de métadonnées masquées seront ignorées.

Fichiers de modèle

Vous pouvez exporter un fichier de modèle pour vous aider à définir votre fichier CSV. Le fichier CSV de modèle est vide, à l'exception d'une ligne d'en-tête détaillant les champs obligatoires et facultatifs, et d'un exemple de ligne fournissant des exemples de mise en forme pour chaque colonne. Dans le modèle, les détails de la cible sont représentés par les colonnes du fichier CSV.

Remarque : La ligne d'en-tête fournie par le modèle est nécessaire pour une importation réussie.

Exporter un fichier CSV prérempli

Pour créer des migrations basées sur des VM sources, ou pour modifier une migration ou un groupe de migrations existant, vous devez d'abord exporter un fichier CSV représentant l'état actuel de vos migrations.

Pour exporter un fichier CSV prérempli, procédez comme suit :

1. Ouvrez la page Migrate to Virtual Machines dans la console Google Cloud.

2. Pour exporter une liste des VM sources, procédez comme suit :

   1. Sélectionnez l'onglet Sources.
   2. Sélectionnez les VM sources que vous souhaitez exporter depuis l'inventaire.
   3. Cliquez sur Exporter pour télécharger le fichier CSV.

3. Pour exporter des groupes de migrations existants, procédez comme suit :

   1. Sélectionnez l'onglet Groupes.
   2. Dans la liste des groupes, sélectionnez les groupes que vous souhaitez exporter.
   3. Cliquez sur Exporter pour télécharger le fichier CSV.

Importer votre fichier CSV

Lorsque vous importez un fichier CSV, celui-ci est validé. Si certaines lignes du fichier contiennent des erreurs, celles-ci vous sont présentées. Vous pouvez choisir d'ignorer ces lignes et d'importer le reste.

Lors de l'importation d'un fichier CSV validé, un plan d'importation vous est présenté. Votre fichier sera importé après approbation du plan.

Pour importer votre fichier CSV :

1. Ouvrez la page Migrate to Virtual Machines dans la console Google Cloud.
2. Sélectionnez l'onglet Groupes, puis sélectionnez Importer.

3. Recherchez votre fichier d'importation. Il doit s'agir d'un fichier CSV de 100 Ko au maximum.

   Conseil : Vous ne pouvez pas importer un fichier CSV lorsqu'une autre importation est déjà en cours.

4. Sélectionnez Importer.

   Si des erreurs sont détectées, elles vous sont présentées à cette étape. Vous pouvez choisir d'ignorer les erreurs et de continuer.

5. Vous recevrez ensuite un plan d'importation. Ce plan présente le détail des actions appelées et des ressources référencées.

6. Sélectionnez Démarrer l'importation pour approuver le plan d'importation et commencer votre importation. Le plan d'importation se met à jour avec la progression de chaque étape.

7. Si l'importation échoue, consultez les messages d'erreur fournis. L'échec d'une étape entraîne l'arrêt de toute la séquence.

8. Si l'importation réussit, sélectionnez Accéder à la page des groupes pour revenir à la page Groupes et consulter vos ressources mises à jour.

   Remarque : En cas d'échec, vous pouvez essayer à nouveau d'importer le même fichier CSV. Compte tenu de la nature du processus d'importation (dans lequel le fichier CSV représente l'état idéal de vos migrations), le processus d'importation et d'exportation ignore les actions déjà terminées et reprend à partir de l'action qui a échoué.

Examiner votre plan d'importation

Un plan d'importation est une liste d'actions générées en fonction des modifications détectées dans votre fichier d'importation. Les types de messages suivants peuvent être répertoriés :

• Créer des migrations.
• Créer un groupe.
• Supprimer des migrations d'un groupe.
• Ajouter des migrations à un groupe.
• Mettre à jour les détails de cible des migrations.

Une fois le plan d'importation accepté, l'état de chaque élément est mis à jour à mesure que l'importation se poursuit. Dans le rapport, vous pouvez consulter l'état d'exécution correspondant à chaque élément (par exemple, En attente, En cours d'exécution, Terminé ou Échec).

Exporter le fichier de modèle de migration

Vous pouvez exporter un fichier de modèle de migration pour plus de détails sur la mise en forme correcte de votre fichier CSV.

Pour exporter votre fichier de modèle de migration, procédez comme suit :

1. Ouvrez la page Migrate to Virtual Machines dans la console Google Cloud.
2. Sélectionnez l'onglet Groupes.
3. Sélectionnez Importer.
4. Sélectionnez Exporter le modèle, après quoi vous serez invité à télécharger le fichier Template.csv.