Accès à vos journaux de migration pour GitHub Enterprise Importer

À propos des journaux de migration

Chaque fois que vous exécutez une migration avec GitHub Enterprise Importer, un journal de migration est créé. Vous devez consulter le journal de migration après chaque migration pour vérifier les éventuels avertissements de migration.

Le journal de migration liste les étapes qui ont été effectuées dans le cadre de la migration et comprend des informations supplémentaires.

• Avertissements de migration, représentant des données (telles que des problèmes, des demandes de tirage ou des commentaires) qui n'ont pas migré contrairement aux attentes
• Qui a exécuté la migration
• La source de la migration
• Combien de temps a pris la migration

Vous pouvez accéder au journal de migration d’une migration de dépôt de plusieurs manières.

• Dans GitHub, en affichant le problème « Journal de migration » dans le dépôt migré. Vous pouvez utiliser ce problème pour discuter des avertissements avec votre équipe et enregistrer les décisions.
• En téléchargeant un fichier journal en utilisant GitHub CLI.

Lorsque vous exécutez une migration d’organisation, GitHub Enterprise Importer crée également un dépôt nommé gei-migration-results dans l’organisation de destination. Ce dépôt contient des informations sur la migration des données au niveau de l’organisation et les duplique dans les problèmes « Journal de migration » pour chaque dépôt migré.

Pour plus d'informations sur l'interprétation des messages d'avertissement dans votre journal de migration, consultez « Résolution des problèmes de votre migration avec GitHub Enterprise Importer. »

Affichage d’un journal de migration de dépôt sur GitHub

Les personnes disposant d’un accès en lecture à un dépôt peuvent accéder au journal de migration du dépôt dans GitHub.

1. Accédez au dépôt migré dans votre organisation de destination.

2. Sous le nom de votre référentiel, cliquez sur Problèmes.

   

3. Cliquez sur le problème avec le titre « Journal de migration ».

Téléchargement d’un journal de migration de dépôt avec GitHub CLI

Les propriétaires d’organisation et les membres d’organisation avec le rôle de migrateur peuvent télécharger les journaux de migration en utilisant GitHub CLI.

Vous pouvez télécharger le dernier journal de migration d’un dépôt individuel à l’aide de la commande download-logs. La commande exacte dépend de votre source de migration.

• Téléchargement d’un journal de migration de dépôt avec l’ADO2GH extension
• Téléchargement d’un journal de migration de dépôt avec l’BBS2GH extension
• Téléchargement d’un journal de migration de dépôt avec l’GEI extension

Les journaux de migration peuvent être téléchargés pendant 24 heures après la fin de la migration.

Téléchargement d’un journal de migration de dépôt avec l’ADO2GH extension

Si votre source de migration est Azure DevOps, vous pouvez télécharger le dernier journal de migration d’un dépôt individuel avec la commande gh ado2gh download-logs. Remplacez DESTINATION par l’organisation de destination, REPOSITORY par le nom du dépôt et FILENAME par un nom de fichier pour le fichier téléchargé.

gh ado2gh download-logs --github-target-org DESTINATION --target-repo REPOSITORY --migration-log-file FILENAME

gh ado2gh download-logs --github-target-org DESTINATION --target-repo REPOSITORY --migration-log-file FILENAME

• Si vous n’avez pas encore de variable d’environnement GH_PAT défini pour un personal access token ayant accès à l’organisation de destination, ajoutez --github-target-pat TOKEN, en remplaçant TOKEN par le personal access token. Pour personal access token consultez « Gestion de l’accès pour une migration à partir d’Azure DevOps. »
• Si vous migrez vers GHE.com, ajoutez --target-api-url TARGET-API-URL, où TARGET-API-URL est l'URL de l'API de base pour le sous-domaine de votre entreprise. Par exemple : https://api.octocorp.ghe.com.

Téléchargement d’un journal de migration de dépôt avec l’BBS2GH extension

Si votre source de migration est Bitbucket Server, vous pouvez télécharger le dernier journal de migration d’un dépôt individuel avec la commande gh bbs2gh download-logs. Remplacez DESTINATION par l’organisation de destination, REPOSITORY par le nom du dépôt et FILENAME par un nom de fichier pour le fichier téléchargé.

gh bbs2gh download-logs --github-target-org DESTINATION --target-repo REPOSITORY --migration-log-file FILENAME

gh bbs2gh download-logs --github-target-org DESTINATION --target-repo REPOSITORY --migration-log-file FILENAME

• Si vous n’avez pas encore de variable d’environnement GH_PAT défini pour un personal access token ayant accès à l’organisation de destination, ajoutez --github-target-pat TOKEN, en remplaçant TOKEN par le personal access token. Pour personal access token consultez « Gestion de l’accès pour une migration à partir de Bitbucket Server. »
• Si vous migrez vers GHE.com, ajoutez --target-api-url TARGET-API-URL, où TARGET-API-URL est l'URL de l'API de base pour le sous-domaine de votre entreprise. Par exemple : https://api.octocorp.ghe.com.

Téléchargement d’un journal de migration de dépôt avec l’GEI extension

Si votre source de migration est un produit GitHub, vous pouvez télécharger le dernier journal de migration d’un dépôt individuel avec la commande gh gei download-logs. Remplacez DESTINATION par l’organisation de destination, REPOSITORY par le nom du dépôt et FILENAME par un nom de fichier pour le fichier téléchargé.

gh gei download-logs --github-target-org DESTINATION --target-repo REPOSITORY --migration-log-file FILENAME

gh gei download-logs --github-target-org DESTINATION --target-repo REPOSITORY --migration-log-file FILENAME

• Si vous n’avez pas encore de variable d’environnement GH_PAT défini pour un personal access token ayant accès à l’organisation de destination, ajoutez --github-target-pat TOKEN, en remplaçant TOKEN par le personal access token. Pour personal access token consultez « Gestion de l'accès pour une migration entre les produits GitHub. »
• Si vous migrez vers GHE.com, ajoutez --target-api-url TARGET-API-URL, où TARGET-API-URL est l'URL de l'API de base pour le sous-domaine de votre entreprise. Par exemple : https://api.octocorp.ghe.com.

Téléchargement de tous les journaux de migration de dépôt pour un script de migration

Pour vous assurer d’avoir accès aux journaux de migration de tous vos dépôts migrés, vous pouvez utiliser l’indicateur --download-migration-logs lors de la génération d’un script de migration pour les migrations de dépôts. Lorsque vous utilisez cet indicateur, le script comprend la commande download-logs pour chaque dépôt migré dans le script. Pour plus d’informations, consultez « À propos de GitHub Enterprise Importer ».

Accès à un journal de migration d’organisation

Les propriétaires de l’organisation de destination peuvent accéder au journal de migration d’une migration d’organisation dans GitHub.

Pour accéder au journal de migration d’une migration d’organisation, accédez au dépôt nommé gei-migration-results dans votre organisation de destination.

Le fichier README.md à la racine du dépôt contient les informations suivantes sur la migration d’organisation :

• Tous les avertissements ou erreurs qui concernent la migration de données au niveau de l’organisation, comme les paramètres et les équipes
• Le nombre de dépôts qui ont été correctement migrés et le nombre de dépôts qui n’ont pas pu être migrés

Les répertoires /success et /failure contiennent un fichier pour chaque dépôt qui a été correctement migré ou qui n’a pas pu être migré, respectivement. Ces fichiers suivent la convention de nommage REPO_NAME.md.