Le centre de migration vous permet d'importer des données de performances et d'utilisation depuis votre infrastructure hébergée chez d'autres fournisseurs de services cloud, comme Amazon Web Services (AWS) et Azure.
Pour importer des données provenant d'autres fournisseurs de services cloud, procédez comme suit:
- Téléchargez le script de collecte.
- Exécuter le script dans votre infrastructure cloud et générer les tables de sortie.
- Importer les tables de sortie à Migration Center.
Bonnes pratiques pour exécuter le script de collecte
Lorsque vous exécutez le script de collecte, tenez compte des points suivants:
- Exécutez le script de collecte à l'aide d'une instance AWS CloudShell (lorsque collecte des données depuis AWS) ou Azure Cloud Shell (lors de la collecte de données depuis Azure, par exemple). L'utilisation de ces shells évite d'avoir à générer, distribuer et Gérer les clés d'authentification pour exécuter le script de collecte dans un autre environnement d'exécution de l'infrastructure.
- Exécutez le script de collecte en usurpant l'identité d'un compte qui dispose des autorisations minimales, en lecture seule. L'utilisation d'autorisations en lecture seule évite tout risque des modifications à vos ressources AWS ou Azure.
- Les scripts sont Open Source. Par conséquent, si votre organisation a des exigences réglementaires spécifiques exigences, examinez le code pour comprendre exactement quel type de données collectées.
Limites
- La taille maximale d'un fichier importé est de 100 Mo.
Télécharger le script
Pour télécharger les scripts, cliquez sur l'un des liens suivants, en fonction de votre fournisseur de services cloud:
Exécuter le script
Pour exécuter le script, suivez les instructions du fichier README de la un dépôt de clés. Le script génère un fichier ZIP contenant les tables des données collectées. Extrayez les fichiers du fichier ZIP.
Importer les résultats du script de collecte
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 Exportations AWS ou Exportations Azure
Cliquez sur Sélectionner les fichiers à importer, puis sélectionnez tous les fichiers à importer. que vous souhaitez mettre en ligne.
Pour confirmer et démarrer l'importation des fichiers, cliquez sur Importer des fichiers.
Si les fichiers sont correctement validés, pour créer les éléments à partir du fichiers, cliquez sur Importer les données, puis sur 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 le le job 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 à associées au job d'importation.
Facultatif : Pour vérifier que le job d'importation a bien été créé, procédez comme suit : pour récupérer le job d'importation.
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_EXPORTED_AWS_CSV
ouIMPORT_JOB_FORMAT_EXPORTED_AZURE_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
signedUrl
de 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 qui est importé.COPIED_URL
: URL signée copiée depuis les étapes d'aperçu.
Facultatif: Répétez les étapes 3 à 6 pour créer d'autres fichiers de données sous le même le job 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 le job ou des fichiers spécifiques, ce qui peut nécessiter 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 échoue et est à 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 lors de l'importation de votre fichier, 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 réussit, Le centre de migration traite ensuite 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 depuis 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 du fichier, sous Progression de l'importation des données : consultez l'état des fichiers que vous avez 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 essayez d'importer à nouveau 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 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, puis affichez une description de celles-ci. Les erreurs du job d'importation de fichiers peuvent empêcher le centre de migration créer des éléments ou mettre à jour des éléments existants en y intégrant les modifications. Pour corriger l'erreur, modifiez vos fichiers et créez un job d'importation de fichiers à importer à nouveau.
Pour en savoir plus sur les messages d'erreur possibles, consultez Résoudre les erreurs d'importation de fichiers
Étape suivante
- En savoir plus sur Méthodes de collecte Migration Center
- Découvrez comment gérer vos importations de fichiers.