Importer des données depuis d'autres fournisseurs cloud

Le centre de migration vous permet d'importer des données de performances et d'utilisation à partir de votre infrastructure hébergée sur d'autres fournisseurs 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écutez le script dans votre infrastructure cloud et générez les tables de sortie.
Importez les tables de sortie dans le centre de migration.

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 Cloud Shell (lors de la collecte de données à partir d'AWS) ou d'Azure Cloud Shell (lors de la collecte de données à partir d'Azure). L'utilisation de ces interfaces système évite d'avoir à générer, distribuer et gérer des clés d'authentification pour exécuter le script de collecte dans d'autres environnements d'exécution.
Exécutez le script de collecte en prenant l'identité d'un compte disposant d'autorisations minimales en lecture seule. L'utilisation d'autorisations en lecture seule évite toute modification accidentelle de vos ressources AWS ou Azure.
Les scripts étant Open Source, si votre organisation a des exigences réglementaires spécifiques, examinez le code pour comprendre exactement quel type de données est collecté.

Limites

La taille maximale d'un fichier importé est de 100 Mo.

Télécharger le script

Pour télécharger les scripts, sélectionnez l'un des liens suivants, en fonction de votre fournisseur cloud:

Exécuter le script

Pour exécuter le script, suivez les instructions du fichier README du dépôt. 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.

Accéder à "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 du fichier importé.
Dans la liste, sélectionnez Exportations AWS ou Exportations Azure.
Cliquez sur Sélectionner les fichiers à importer, puis sélectionnez tous les fichiers que vous souhaitez importer.

Remarque:Pour les fichiers AWS et Azure, vous ne pouvez pas importer directement le fichier ZIP généré par le script. Vous devez toutefois d'abord extraire les fichiers, puis importer les fichiers CSV.
Pour confirmer et commencer à importer les fichiers, cliquez sur Importer des fichiers.
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

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.

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

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_EXPORTED_AWS_CSV ou IMPORT_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 du champ signedUrl 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é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

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
```

Exécutez le job d'importation.

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

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:

Accédez à la page Importation de données, puis cliquez sur Importations de fichiers.
Dans la liste des fichiers importés, sélectionnez l'importation que vous souhaitez vérifier.
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:

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 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.

Étapes suivantes

Apprenez-en davantage sur les méthodes de collection du centre de migration.
Découvrez comment gérer vos importations de fichiers.