Le centre de migration 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 ne dispose que d'un nombre limité d'éléments et que vous souhaitez créer manuellement les données.
Pour importer les tableaux que vous avez remplis manuellement, procédez comme suit:
- Téléchargez les modèles dans 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 vous fournit les modèles de fichiers que vous pouvez utiliser pour importer vos données d'infrastructure dans Migration Center. Les modèles contiennent des exemples de données pour vous aider à remplir la table. Pour obtenir une description détaillée du format de données requis, consultez la section 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, ainsi que 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 les données de performances de vos éléments dans un format de série temporelle. |
| diskInfo.csv | Données de 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 libellés aux éléments. Les libellés doivent respecter les conditions requises pour les libellés dans Google Cloud. |
Pour en savoir plus sur les spécifications de chaque fichier, consultez la section 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 de l'importation de fichiers.
Dans la liste Format de fichier, sélectionnez Modèles CSV remplis manuellement.
Cliquez sur Sélectionner des fichiers à importer, puis sélectionnez tous les fichiers que vous souhaitez importer.
Pour confirmer et commencer à importer les fichiers, cliquez sur Importer des fichiers.
Si les fichiers sont validés correctement, cliquez sur Importer des données, puis sur Confirmer pour créer les composants à partir des fichiers.
API
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 la tâche d'importation.REGION: région dans laquelle créer la tâche 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 la tâche d'importation a été créée correctement, récupérez-la.
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
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éesIMPORT_JOB_FORMAT:IMPORT_JOB_FORMAT_MANUAL_CSV
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
Copiez l'URL du champ
signedUrlde la réponse.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 du fichier importé.COPIED_URL: URL signée copiée à partir des étapes de prévisualisation.
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.
Facultatif: Obtenez tous les fichiers de données d'une tâche d'importation.
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles
Validez la tâche d'importation.
POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:validate
Obtenez la tâche d'importation et affichez le rapport de validation. Si l'état est
READY, vous pouvez passer aux étapes suivantes. Dans le cas contraire, vous devez corriger la tâche ou des fichiers spécifiques. Pour ce faire, 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 la tâche d'importation.
POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:run
Obtenez la tâche 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 qu'elle est dans un état terminal, le rapport d'exécution inclut les erreurs. Créez une tâche 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 votre fichier, découvrez comment résoudre les problèmes courants liés aux messages d'erreur.
Examiner 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 éléments ou en mettre à jour des existants. Vous pouvez vérifier l'état de vos tâches d'importation depuis la console Google Cloud.
Pour vérifier l'état de votre tâche 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 l'importation que vous souhaitez examiner.
- Sur la page d'importation de fichiers, sous Progression de l'importation des données, vérifiez l'état de vos fichiers importés.
Vos fichiers peuvent avoir l'un des états suivants.
Liste des états
- Terminé : 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 attend la fin du traitement d'un autre fichier.
- En cours : 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 tâche 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 des détails du fichier d'importation affiche la liste complète des erreurs.
Sur la page d'informations du fichier d'importation, vous pouvez consulter les éléments et les champs de données à l'origine des erreurs, ainsi qu'une description de l'erreur. Des erreurs dans la tâche d'importation de fichiers peuvent empêcher Migration Center de créer des composants ou de mettre à jour les composants existants avec les nouvelles modifications. Pour corriger l'erreur, modifiez vos fichiers et créez une nouvelle tâche d'importation de fichiers pour les importer à nouveau.
Pour en savoir plus sur les messages d'erreur possibles, consultez la section 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 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 | Espace total 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 du système d'exploitation de la machine. |
| MachineStatus | chaîne | État de la machine. |
| ProvisioningState | chaîne | État de provisionnement, pour les VM Azure uniquement. |
| CreateDate | Horodatage | 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 | Espace total utilisé sur le disque. |
| StorageTypeLabel | chaîne | Type de libellé de 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 du processeur utilisée. Il doit être compris entre 0 et 100. |
| MemoryUtilizationPercentage | float | Pourcentage de mémoire système utilisée. Il doit être compris entre 0 et 100. |
| UtilizedMemoryBytes | float | Mémoire totale utilisée, en octets. |
| DiskReadOperationsPerSec | float | IOPS moyens échantillonnés sur une courte période. |
| DiskWriteOperationsPerSec | float | IOPS moyens échantillonnés sur une courte période. |
| NetworkBytesPerSecSent | float | Débit de sortie réseau moyen en B/s, échantillonné sur une courte période. |
| NetworkBytesPerSecReceived | float | Flux d'entrée réseau moyen en B/s, échantillonné sur une courte période. |
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 du libellé. |
Algorithme d'analyse des libellés
Les libellés que vous importez avec le fichier tagInfo doivent respecter les exigences concernant les libellés dans Google Cloud. Si le libellé ne respecte pas les exigences, Migration Center utilise la stratégie suivante pour le convertir:
- Pour les clés uniquement, il supprime tous les caractères de début qui ne sont pas des lettres de l'alphabet anglais.
- Il remplace toutes les lettres majuscules par des lettres minuscules.
- Il remplace tous les caractères non valides par des traits de soulignement (
_). - Il tronque le libellé à 62 caractères maximum.
- Il 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.
Étape suivante
- Découvrez les méthodes de collecte de Migration Center.
- Découvrez comment gérer vos importations de fichiers.