Créer et importer manuellement des tables de données

Migration Center vous permet d'importer des tableaux de données que vous remplissez manuellement à l'aide des modèles fournis. Cette option est utile si votre infrastructure dispose d'un nombre limité d'éléments et que vous souhaitez créer manuellement les données.

Pour créer et importer manuellement des tables de données, procédez comme suit :

  1. Téléchargez les modèles à partir de la liste des modèles disponibles.
  2. Remplissez manuellement les tableaux avec les données de votre infrastructure.
  3. Importez les tables dans Migration Center.

Limites

  • La taille maximale d'un fichier importé est de 100 Mo.

Modèles de données disponibles

Le tableau suivant fournit les modèles de fichiers que vous pouvez utiliser pour importer vos données d'infrastructure dans le centre de migration. Les modèles contiennent des exemples de données pour vous aider à remplir le tableau. Pour obtenir une description détaillée du format de données requis, consultez Spécifications des fichiers d'importation.

Nom de fichier Type de données Description
vmInfo.csv Informations sur l'ordinateur Utilisez ce modèle pour fournir des informations sur des éléments individuels, y compris le processeur, la mémoire, ainsi que d'autres paramètres de configuration. Ce tableau est obligatoire chaque fois que vous créez une importation.
perfInfo.csv Données de performance Facultatif : utilisez ce modèle pour fournir les données de performances de vos composants dans un format de série temporelle.
diskInfo.csv Données du disque Facultatif : Utilisez ce modèle pour fournir des informations concernant les disques et leur utilisation.
tagInfo.csv Tags système Facultatif : Utilisez ce modèle pour attribuer des attributs clé-valeur à vos ressources Amazon Web Services (AWS). Les attributs sont au format "tag:KEY" : "VALUE". Par exemple, "tag:Name" : "AWS-example".

Pour en savoir plus sur les spécifications de chaque fichier, consultez Spécifications des fichiers d'importation.

Importer les tables

Pour importer les fichiers, procédez comme suit :

Console

  1. Accédez à la page Importation de données.

    Accéder à l'importation de données

  2. Cliquez sur Ajouter des données> Importer des fichiers.

  3. Dans la section Configurer l'importation de fichiers, saisissez le nom de l'importation de fichiers.

  4. Dans la liste Format de fichier, sélectionnez Modèles CSV remplis manuellement.

  5. Cliquez sur Sélectionner des fichiers à importer, puis sélectionnez tous les fichiers que vous souhaitez importer.

  6. Pour confirmer et commencer à importer les fichiers, cliquez sur Importer des fichiers.

  7. Si les fichiers sont correctement validés, cliquez sur Importer des données, puis sur Confirmer pour créer les composants à partir des fichiers.

API

  1. Créez une tâche d'importation.

    POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs?importJobId=IMPORT_JOB_ID

{
  "asset_source": "projects/PROJECT_ID/locations/REGION/sources/SOURCE_ID"
}

    Remplacez les éléments suivants :

    • PROJECT_ID : ID du projet dans lequel créer le job d'importation.
    • REGION : région dans laquelle créer le job d'importation.
    • IMPORT_JOB_ID : ID du nouveau job d'importation.
    • SOURCE_ID : ID d'une source existante à associer au job d'importation.

  2. Facultatif : Pour vérifier que le job d'importation a été créé correctement, récupérez-le.

    GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID

  3. Créez un fichier de données d'importation joint à la tâche d'importation.

    POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles?import_data_file_id=DATA_FILE_ID

{
  "format": "IMPORT_JOB_FORMAT"
}

    Remplacez les éléments suivants :

    • DATA_FILE_ID : ID du nouveau fichier de données
    • IMPORT_JOB_FORMAT : IMPORT_JOB_FORMAT_MANUAL_CSV

  4. Obtenez le fichier de données.

    GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles/DATA_FILE_ID

  5. Copiez l'URL du champ signedUrl de la réponse.

  6. Importez un fichier à l'URL copiée.

    PUT -H 'Content-Type: application/octet-stream' --upload-file UPLOAD_FILE_PATH 'COPIED_URL'

    Remplacez les éléments suivants :

    • UPLOAD_FILE_PATH : chemin d'accès local au fichier importé.
    • COPIED_URL : URL signée copiée lors des étapes précédentes.

  7. Facultatif : Répétez les étapes 3 à 6 pour créer d'autres fichiers de données dans le même job d'importation.

  8. Facultatif : Obtenez tous les fichiers de données d'un job d'importation.

    GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles

  9. Validez le job d'importation.

    POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:validate

  10. Obtenez le job d'importation et affichez le rapport de validation. Si l'état est READY, vous pouvez passer aux étapes suivantes. Sinon, vous devez corriger le job ou les fichiers spécifiques. Pour cela, vous devrez peut-être supprimer des fichiers ou en importer de nouveaux.

    GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID

  11. Exécutez le job d'importation.

    POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:run

  12. Obtenez le job d'importation et consultez le rapport d'exécution. Si l'état est COMPLETED, la tâche a bien été exécutée. Sinon, si le job a échoué et se trouve dans un état terminal, le rapport d'exécution inclut les erreurs. Créez un job d'importation et apportez les modifications nécessaires.

    GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID

Si vous rencontrez des problèmes lors de l'importation de votre fichier, découvrez comment résoudre les messages d'erreur courants.

Vérifier l'importation

Une fois vos fichiers importés, le centre de migration les valide pour vérifier qu'ils sont formellement corrects. Si la validation réussit, Migration Center traite les données pour créer des composants ou mettre à jour ceux existants. Vous pouvez vérifier l'état de vos jobs d'importation dans la console Google Cloud .

Pour vérifier l'état de votre job d'importation, procédez comme suit :

  1. Accédez à la page Importation de données, puis cliquez sur Importations de fichiers.
  2. Dans la liste des importations de fichiers, sélectionnez l'importation que vous souhaitez examiner.
  3. Sur la page d'importation de fichiers, sous Progression de l'importation des données, consultez l'état des fichiers importés.

Vos fichiers peuvent avoir l'un des états suivants.

Liste des états

  • Terminée : L'importation de votre fichier a bien été effectuée.
  • Prêt. Votre fichier a été validé et est prêt à être importé.
  • En attente : Votre fichier est en attente du traitement d'un autre fichier.
  • En cours d'exécution : Votre fichier est en cours de traitement.
  • Validation Votre fichier est en cours de validation.
  • Échec de la validation. Votre fichier contient des erreurs. Corrigez les erreurs, puis réessayez d'importer votre fichier.
  • Échec. Impossible d'importer votre fichier.

Consulter les détails des erreurs

Si vous rencontrez des erreurs après avoir importé vos fichiers, vous pouvez consulter le message d'erreur directement dans la console Google Cloud .

Pour examiner les erreurs de votre job d'importation, procédez comme suit :

  1. Accédez à la page Importation de données, puis cliquez sur Importations de fichiers.
  2. Cliquez sur le fichier d'importation qui affiche un avertissement ou une erreur. La page des détails du fichier d'importation affiche la liste complète des erreurs.

Sur la page d'informations sur le fichier d'importation, vous pouvez examiner les composants et les champs de données qui sont à l'origine des erreurs, et afficher une description de l'erreur. Des erreurs dans le job d'importation de fichiers peuvent empêcher Migration Center de créer des composants ou de mettre à jour ceux existants avec les nouvelles modifications. Pour corriger l'erreur, modifiez vos fichiers et créez une tâche d'importation pour les importer de nouveau.

Pour en savoir plus sur les messages d'erreur possibles, consultez Résoudre les erreurs d'importation de fichiers.

Spécifications des fichiers d'importation

Les tableaux suivants présentent les caractéristiques techniques des fichiers modèles utilisés pour l'importation manuelle.

Fichier vmInfo

Colonne Type attendu Description
MachineId chaîne Identifiant unique de la machine virtuelle.
MachineName chaîne Nom à afficher de la machine virtuelle.
PrimaryIPAddress chaîne Adresse IP de la machine.
PrimaryMACAddress chaîne Adresse MAC de la machine. Il ne sert qu'à identifier la machine.
PublicIPAddress chaîne Adresse IP publique de la machine.
IpAddressListSemiColonDelimited Liste des messages Liste des adresses réseau allouées ou attribuées.
TotalDiskAllocatedGiB int64 Capacité totale du disque.
TotalDiskUsedGiB int64 Quantité totale d'espace utilisé sur le disque.
MachineTypeLabel chaîne Libellé du type de machine AWS ou Azure.
AllocatedProcessorCoreCount int64 Nombre de cœurs de processeur dans la machine virtuelle.
MemoryGiB int32 Quantité de mémoire de la machine virtuelle.
HostingLocation chaîne Emplacement de la machine au format AWS ou Azure.
OsType chaîne OS de la machine.
OsName chaîne OS de la machine.
OsVersion chaîne Version de l'OS de la machine.
MachineStatus chaîne État de l'alimentation de la machine.
ProvisioningState chaîne État de provisionnement, pour les VM Azure uniquement.
CreateDate Horodatage Horodatage de création de la machine.
IsPhysical chaîne Si la machine est physique ou virtuelle.
Source message Détails de la source pour les machines AWS ou Azure.

Fichier diskInfo

Colonne Type attendu Description
MachineId chaîne Identifiant unique de la machine virtuelle.
DiskLabel chaîne Libellé du disque.
SizeInGib int64 Capacité totale du disque.
UsedInGib int64 Quantité totale d'espace utilisé sur le disque.
StorageTypeLabel chaîne Type de libellé du disque (par exemple, BIOS ou GPT).

Fichier perfInfo

Colonne Type attendu Description
MachineId chaîne Identifiant unique de la machine virtuelle.
Code temporel Code temporel de la collecte de l'échantillon.
CpuUtilizationPercentage Nombre à virgule flottante Pourcentage de la capacité totale du processeur utilisée. Elle doit être comprise dans l'intervalle 0-100.
MemoryUtilizationPercentage Nombre à virgule flottante Pourcentage de mémoire système utilisée. Elle doit être comprise dans l'intervalle 0-100.
UtilizedMemoryBytes Nombre à virgule flottante Mémoire totale utilisée, en octets.
DiskReadOperationsPerSec Nombre à virgule flottante Moyenne des IOPS échantillonnées sur une courte période.
DiskWriteOperationsPerSec Nombre à virgule flottante Moyenne des IOPS échantillonnées sur une courte période.
NetworkBytesPerSecSent Nombre à virgule flottante Moyenne de la sortie réseau en octets/s, échantillonnée sur une courte période.
NetworkBytesPerSecReceived Nombre à virgule flottante Ingress réseau moyen en octets/s, échantillonné sur une courte période.

Fichier tagInfo

Colonne Type attendu Description
Clé chaîne Clé de l'attribut.
Valeur chaîne Valeur de l'attribut.

Étapes suivantes