Importer des tables générées manuellement

Le centre de migration vous permet d'importer des tables de données que vous remplissez manuellement à l'aide des modèles fournis. Cela est utile si votre infrastructure comporte un nombre limité d'éléments et que vous souhaitez créer les données manuellement.

Pour importer les tables que vous avez renseignées manuellement, procédez comme suit:

  1. Téléchargez les modèles dans la liste des modèles disponibles.
  2. Remplissez manuellement les tables avec les données de votre infrastructure.
  3. Importez les tables dans le centre de migration.

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 qui suggèrent comment remplir le tableau. Pour obtenir une description détaillée du format de données requis, consultez les spécifications des fichiers d'importation.

Nom du 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 et d'autres paramètres de configuration. Cette table est requise chaque fois que vous créez une importation.
perfInfo.csv Données de performance Facultatif: utilisez ce modèle pour fournir des données sur les performances de vos éléments dans un format de série temporelle.
diskInfo.csv Données du disque Facultatif: utilisez ce modèle pour fournir des informations sur les disques et leur utilisation.
tagInfo.csv Tags système Facultatif: utilisez ce modèle pour attribuer des libellés aux éléments. Les étiquettes doivent respecter les exigences relatives aux étiquettes dans Google Cloud.

Pour en savoir plus sur les spécifications de chaque fichier, consultez la section Spécifications concernant les 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 à "Importation de données"

  2. Cliquez sur Add Data (Ajouter des données). Une nouvelle page s'ouvre.

  3. Sélectionnez Importer des fichiers, puis sous Configurer l'importation de fichiers, saisissez le nom du fichier importé.

  4. Dans la liste, sélectionnez Modèles CSV renseignés manuellement.

  5. Cliquez sur Sélectionner les 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 Import data (Importer des données), puis sur Confirm (Confirmer) pour créer les éléments à partir des fichiers.

API

  1. Créez un job 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 pour créer la tâche 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 à la tâche d'importation.
  2. Facultatif: Pour vérifier que le job d'importation a été créé correctement, obtenez-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 au job 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. Récupérez 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 dans 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 du fichier importé.
    • COPIED_URL: URL signée copiée à partir des étapes d'aperçu.
  7. (Facultatif) Répétez les étapes 3 à 6 pour créer d'autres fichiers de données dans la même tâche d'importation.

  8. (Facultatif) Récupérez 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 la tâche ou des fichiers spécifiques. 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 affichez le rapport d'exécution. Si l'état est COMPLETED, la tâche a bien été exécutée. Sinon, si la tâche a échoué et se trouve à l'état final, le rapport d'exécution inclut les erreurs. Créez un job d'importation et appliquez les modifications requises.

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

Si vous rencontrez des problèmes avec l'importation de vos fichiers, découvrez comment résoudre les problèmes liés aux messages d'erreur courants.

Vérifier l'importation

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

Pour consulter 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 fichiers importés, sélectionnez l'importation que vous souhaitez vérifier.
  3. Sur la page d'importation des fichiers, sous Progression de l'importation des données, vérifiez l'état des fichiers importés.

Vos fichiers sont associés à l'un des états suivants.

Liste des états

  • Terminé : Votre fichier a bien été importé.
  • Prêt : Votre fichier a été validé et est prêt à être importé.
  • En attente : Votre fichier est en attente de 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.

Examiner les détails de l'erreur

Si vous rencontrez des erreurs après l'importation de 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 d'informations sur le fichier d'importation affiche la liste complète des erreurs.

Sur la page d'informations du fichier d'importation, vous pouvez examiner les éléments et les champs de données à l'origine des erreurs, et afficher une description de l'erreur. Les erreurs liées au job d'importation de fichiers peuvent empêcher le centre de migration de créer des éléments ou de mettre à jour les éléments existants avec les nouvelles modifications. Pour corriger l'erreur, modifiez vos fichiers et créez un job d'importation de fichiers pour les réimporter.

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

Spécifications des fichiers d'importation

Les tableaux suivants présentent les spécifications techniques des fichiers de modèle 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 sert uniquement à identifier la machine.
PublicIPAddress chaîne Adresse IP publique de la machine.
IpAddressListSemiColonDelimited Liste de 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 Étiquette 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 du système d'exploitation de la machine.
MachineStatus chaîne État de la puissance de la machine.
ProvisioningState chaîne État du provisionnement, pour les VM Azure uniquement.
CreateDate Code temporel Code temporel de création de la machine.
IsPhysical chaîne Indique s'il s'agit d'une machine 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 Étiquette du disque.
SizeInGib int64 Capacité totale du disque.
UsedInGib int64 Quantité totale d'espace utilisé sur le disque.
StorageTypeLabel chaîne Type d'étiquette du disque (par exemple, BIOS ou GPT).

Fichier perfInfo

Colonne Type attendu Description
MachineId chaîne Identifiant unique de la machine virtuelle.
TimeStamp Horodatage de la collecte de l'échantillon.
CpuUtilizationPercentage float Pourcentage de la capacité totale du processeur utilisée. Elle doit être comprise entre 0 et 100.
MemoryUtilizationPercentage float Pourcentage de mémoire système utilisé. Elle doit être comprise entre 0 et 100.
UtilizedMemoryBytes float Mémoire totale utilisée en octets.
DiskReadOperationsPerSec float IOPS moyennes échantillonnées sur une courte période.
DiskWriteOperationsPerSec float IOPS moyennes échantillonnées sur une courte période.
NetworkBytesPerSecSent float Sortie réseau moyenne en o/s, échantillonnée sur une courte période.
NetworkBytesPerSecReceived float Entrée réseau moyenne en o/s, échantillonnée sur une courte fenêtre.

Fichier tagInfo

Colonne Type attendu Description
MachineId chaîne Identifiant unique de la machine virtuelle.
Clé chaîne Clé du libellé.
Valeur chaîne Valeur de l'étiquette.

Algorithme d'analyse des étiquettes

Les étiquettes que vous importez avec le fichier tagInfo doivent respecter les exigences relatives aux étiquettes dans Google Cloud. Si le libellé n'est pas conforme aux exigences, le centre de migration utilise la stratégie suivante pour le convertir:

  1. Pour les clés uniquement, elle supprime tous les caractères de début qui ne sont pas des lettres de l'alphabet anglais.
  2. Il remplace toutes les majuscules par des minuscules.
  3. Il remplace tous les caractères non valides par des traits de soulignement (_).
  4. Il tronque le libellé à un maximum de 62 caractères.
  5. Elle ajoute le suffixe _<CRC32>, calculé en fonction de la chaîne d'origine.

Un message d'avertissement s'affiche chaque fois qu'un libellé est converti.

Si la validation échoue ou si la clé existe déjà, l'importation ignore la ligne et un message d'avertissement s'affiche.

Étapes suivantes