Le centre de migration vous permet d'importer des tables de données que vous remplissez manuellement à l'aide des modèles fournis. Cette approche 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 dans la liste des modèles disponibles.
- Remplissez manuellement les tables avec les données de votre infrastructure.
- Importez les tables dans le centre de migration.
Limites
- La taille maximale d'une importation de fichier est de 100 Mo.
Modèles de données disponibles
Le tableau suivant vous fournit les modèles de fichier 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 la section Importer des spécifications pour les fichiers.
| 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 les paramètres du processeur, de la mémoire et d'autres paramètres de configuration. Cette table 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 é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 assets. Les étiquettes doivent respecter les conditions requises pour les étiquettes dans Google Cloud. |
Pour en savoir plus sur les spécifications de chaque fichier, consultez Importer des spécifications pour les fichiers.
Importer les tables
Pour importer les fichiers:
Console
Accédez à la page Importation de données.
Cliquez sur Add Data (Ajouter des données). Une nouvelle page s'ouvre.
Sélectionnez Importer des fichiers, puis sous Configurer l'importation de fichiers, saisissez le nom de l'importation.
Dans la liste, sélectionnez Modèles CSV renseignés manuellement.
Cliquez sur Sélectionner les 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, pour créer les éléments à partir des fichiers, cliquez sur Importer les données, puis sur Confirmer.
API
créer 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 pour 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.
Facultatif: pour vérifier que la tâche d'importation a bien été créée, 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 associé à 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
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 du champ
signedUrlà partir de la réponse.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.
(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: récupérer 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 le job d'importation.
POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:validate
Obtenir le job d'importation et afficher 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. Cela peut nécessiter la suppression de fichiers ou l'importation de nouveaux fichiers.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
Obtenir le job d'importation et afficher le rapport d'exécution Si l'état est
COMPLETED, le job a bien été exécuté. Sinon, si la tâche échoue et se trouve dans un état final, les erreurs sont consignées dans le rapport d'exécution. 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 fichiers, découvrez comment résoudre les problèmes d'erreur courants.
Examiner l'importation
Une fois les fichiers importés, le centre de migration les valide pour vérifier leur exactitude formelle. Si la validation aboutit, le centre de migration 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 tâches d'importation depuis la console Google Cloud.
Pour consulter l'état de votre tâche d'importation, procédez comme suit:
- Accédez à la page Importation de données, puis cliquez sur Importer des 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, examinez l'état de vos fichiers importés.
Vos fichiers peuvent être associés à l'un des états suivants.
Liste des états
- Terminé : L'importation de votre fichier a réussi.
- Prêt : Votre fichier a été validé et est prêt à être importé.
- En attente. Votre fichier est en attente de traitement.
- 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 votre fichier.
- Échec. Impossible d'importer votre fichier.
Examiner les détails de l'erreur
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 la tâche d'importation, procédez comme suit:
- Accédez à la page Importation de données, puis cliquez sur Importer des fichiers.
- Dans la colonne Erreur, cliquez sur Afficher. La page Détails de l'erreur affiche la liste complète des erreurs.
Sur la page Détails de l'erreur, vous pouvez examiner les éléments et les champs de données à l'origine de l'erreur, et afficher sa description. Des erreurs dans le job d'importation de fichiers peuvent empêcher le centre de migration de créer des éléments ou d'en modifier les existants. Pour corriger l'erreur, modifiez vos fichiers et créez une tâche d'importation de fichiers afin de 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 |
|---|---|---|
| ID machine | string | Identifiant unique de la machine virtuelle. |
| Nom de la machine | string | Nom à afficher de la machine virtuelle. |
| Adresse IP principale | string | Adresse IP de la machine. |
| Adresse MAC principale | string | Adresse MAC de la machine. Cette information sert uniquement à identifier la machine. |
| Adresse IP publique | string | Adresse IP publique de la machine. |
| IpAddressListSemiColonDelimited | Liste des messages | Liste des adresses réseau attribuées ou attribuées. |
| GioTotalDiskAllocalized | int64 | Capacité totale du disque. |
| TotalDiskUsedGio | int64 | Espace total utilisé sur le disque. |
| Étiquette de machine | string | Libellé de type de machine AWS ou Azure. |
| Nombre d'emplacements du processeur | int64 | Nombre de cœurs de processeur dans la machine virtuelle. |
| Mémoire en Gio | int32 | Quantité de mémoire de la machine virtuelle. |
| HostingLocation | string | Emplacement de la machine au format AWS ou Azure. |
| OsType | string | OS de la machine. |
| Nom de l'OS | string | OS de la machine. |
| Version du système d'exploitation | string | Version du système d'exploitation de la machine. |
| État de la machine | string | État de puissance de la machine. |
| ProvisioningState | string | État du provisionnement, pour les VM Azure uniquement. |
| Date de création | Code temporel | Horodatage de création de la machine. |
| Est physique | string | Si la machine est une machine physique ou virtuelle. |
| Source | Message | Détails de la source pour les machines AWS ou Azure. |
Fichier diskInfo
| Colonne | Type attendu | Description |
|---|---|---|
| ID machine | string | Identifiant unique de la machine virtuelle. |
| Libellé de disque | string | Libellé de disque. |
| Taille InGib | int64 | Capacité totale du disque. |
| UtiliséGib | int64 | Espace total utilisé sur le disque. |
| Étiquette de type de stockage | string | Type d'étiquette de disque (par exemple, BIOS ou GPT). |
Fichier perfInfo
| Colonne | Type attendu | Description |
|---|---|---|
| ID machine | string | Identifiant unique de la machine virtuelle. |
| TimeStamp | L'horodatage de la collecte de l'échantillon. | |
| Pourcentage d'utilisation | float | Pourcentage de la capacité totale du processeur utilisée. Elle doit être comprise entre 0 et 100. |
| Pourcentage d'utilisation de la mémoire | float | Pourcentage de mémoire système utilisé. Elle doit être comprise entre 0 et 100. |
| Octets de mémoire utilisés | float | Mémoire totale utilisée en octets. |
| disqueReadOperationsPerSec | float | Nombre moyen d'IOPS échantillonnées sur une courte période. |
| DiskWriteOperationsPerSec | float | Nombre moyen d'IOPS échantillonnées sur une courte période. |
| Octets réseau par seconde | float | Sortie réseau moyenne en B/s, échantillonnée sur une courte période. |
| Nombre d'octets sur le réseau reçu | float | Entrée réseau moyenne en B/s, échantillonnée sur une courte période. |
Fichier tagInfo
| Colonne | Type attendu | Description |
|---|---|---|
| ID machine | string | Identifiant unique de la machine virtuelle. |
| Clé | string | Clé du libellé. |
| Valeur | string | Valeur du libellé. |
Algorithme d'analyse pour les étiquettes
Les étiquettes que vous importez avec le fichier tagInfo doivent respecter les exigences concernant les étiquettes dans Google Cloud. Si le libellé ne respecte pas les exigences, le centre de migration 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 est tronqué à 62 caractères.
- 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.
Étapes suivantes
- En savoir plus sur les méthodes de collecte du centre de migration
- Découvrez comment gérer vos importations de fichiers.