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éé. Le journal de migration liste les étapes qui ont été effectuées dans le cadre de la migration et comprend des informations supplémentaires.

• Qui a exécuté la migration
• La source de la migration
• Combien de temps a pris la migration
• Toutes les ressources qui n’ont pas migré comme prévu

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’erreur 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 personnes avec le rôle de migrateur peuvent télécharger les journaux de migration en utilisant GitHub CLI. Pour plus d’informations sur le rôle de migrateur, consultez « Octroi du rôle de migrateur pour GitHub Enterprise Importer ».

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. Replace DESTINATION with the destination organization, REPOSITORY with the repository name, and FILENAME with a file name for the downloaded file.

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

If you don't already have a GH_PAT environment variable set for a personal access token with access to the destination organization, add --github-target-pat TOKEN, replacing TOKEN with the personal access token. For personal access token requirements, see "Gestion de l’accès pour GitHub Enterprise Importer."

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. Replace DESTINATION with the destination organization, REPOSITORY with the repository name, and FILENAME with a file name for the downloaded file.

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

If you don't already have a GH_PAT environment variable set for a personal access token with access to the destination organization, add --github-target-pat TOKEN, replacing TOKEN with the personal access token. For personal access token requirements, see "Gestion de l’accès pour GitHub Enterprise Importer."

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. Replace DESTINATION with the destination organization, REPOSITORY with the repository name, and FILENAME with a file name for the downloaded file.

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

If you don't already have a GH_PAT environment variable set for a personal access token with access to the destination organization, add --github-target-pat TOKEN, replacing TOKEN with the personal access token. For personal access token requirements, see "Gestion de l’accès pour GitHub Enterprise Importer."

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 « Migration de dépôts avec 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.