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 dispose d'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:
- Téléchargez les modèles à partir de la liste des modèles disponibles.
- Remplissez manuellement les tableaux avec les données de votre infrastructure.
- 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 fichier que vous pouvez utiliser pour importer vos données d'infrastructure dans Migration Center. 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 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 concernant les étiquettes dans Google Cloud. |
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
Accédez à la page Importation de données.
Cliquez sur Ajouter des données > Importer des fichiers.
Dans la section Configurer l'importation de fichiers, saisissez le nom du fichier à importer.
Dans la liste Format de fichier, sélectionnez Modèles CSV remplis manuellement.
Cliquez sur Sélectionner les fichiers à importer, puis sélectionnez tous les fichiers à importer.
Pour confirmer et démarrer l'importation des fichiers, cliquez sur Importer des fichiers.
Si les fichiers sont validés correctement, pour créer les éléments à partir des fichiers, cliquez sur Import data (Importer les données), puis sur Confirm (Confirmer).
API
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 dans lequel créer la tâche d'importation.REGION: région dans laquelle créer le job d'importation.IMPORT_JOB_ID: ID de la nouvelle tâche d'importation.SOURCE_ID: ID d'une source existante à associer à la tâche d'importation.
Facultatif: Pour vérifier que le job d'importation a bien été créé, obtenez-le.
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
Créez un fichier de données d'importation associé 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éesIMPORT_JOB_FORMAT:IMPORT_JOB_FORMAT_MANUAL_CSV
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
Copiez l'URL figurant dans le champ
signedUrlde la réponse.Importez un fichier vers 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.
Facultatif: Répétez les étapes 3 à 6 pour créer d'autres fichiers de données sous la même tâche d'importation.
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
Validez le job d'importation.
POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:validate
Récupérez 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
Exécutez le job d'importation.
POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:run
Récupérez 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 dans un é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 lors de 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, Migration Center les valide pour vérifier s'ils sont formellement corrects. Si la validation aboutit, Migration Center traite les données pour créer des éléments ou mettre à jour des éléments 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:
- Accédez à la page Importation de données, puis cliquez sur Importations de fichiers.
- Dans la liste des importations de fichiers, sélectionnez celle que vous souhaitez examiner.
- Sur la page d'importation des fichiers, sous Progression de l'importation des données, consultez l'état de vos fichiers importés.
Vos fichiers peuvent avoir 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 phase de validation.
- Échec de la validation. Votre fichier contient des erreurs. Corrigez les erreurs, puis réessayez d'importer le 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:
- Accédez à la page Importation de données, puis cliquez sur Importations de fichiers.
- 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 au niveau du job d'importation de fichiers peuvent empêcher le centre de migration de créer des éléments ou de mettre à jour des é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 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 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 | Système d'exploitation de la machine. |
| OsName | chaîne | Système d'exploitation de la machine. |
| OsVersion | chaîne | Version de l'OS de la machine. |
| MachineStatus | chaîne | État de la puissance de la machine. |
| ProvisioningState | chaîne | État de provisionnement, pour les VM Azure uniquement. |
| CreateDate | Code temporel | Code temporel 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 | É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 | Code temporel de la collecte de l'échantillon. | |
| CpuUtilizationPercentage | float | Pourcentage de la capacité totale utilisée par le processeur. 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 fenêtre. |
| DiskWriteOperationsPerSec | float | IOPS moyennes échantillonnées sur une courte fenêtre. |
| NetworkBytesPerSecSent | float | Sortie réseau moyenne en octets/s, échantillonnée sur une courte fenêtre. |
| NetworkBytesPerSecReceived | float | Entrée réseau moyenne en octets/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 concernant les étiquettes dans Google Cloud. Si l'étiquette n'est pas conforme aux exigences, Migration Center utilise la stratégie suivante pour le convertir:
- Pour les clés uniquement, tous les caractères de début qui ne sont pas des lettres de l'alphabet anglais sont supprimés.
- Toutes les lettres majuscules sont remplacées par des minuscules.
- Tous les caractères non valides sont remplacés par des traits de soulignement (
_). - Elle tronque le libellé jusqu'à un maximum de 62 caractères.
- 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
- Apprenez-en davantage sur les méthodes de collecte du centre de migration.
- Découvrez comment gérer vos importations de fichiers.