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

Dans cet article

Pour passer en revue un enregistrement d’événements et d’erreurs qui se sont produits lors d’une migration de dépôt, vous pouvez accéder au journal de migration sur GitHub ou en utilisant GitHub CLI.

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

    Capture d’écran de la page principale d’un dépôt. Dans la barre de navigation horizontale, un onglet intitulé « Problèmes » est indiqué en orange foncé.

  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.

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

Shell
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 connaître les exigences en termes de personal access token, consultez « 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. 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é.

Shell
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 connaître les exigences en termes de personal access token, consultez « 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. 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é.

Shell
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 connaître les exigences en termes de personal access token, consultez « 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 ».

Remarque : Vous pouvez uniquement utiliser l’indicateur --download-migration-logs avec les migrations de dépôts, pas avec les migrations d’organisations.

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.

Remarque : Le dépôt gei-migration-results est créé au début du processus de migration, mais n’est mis à jour avec vos journaux de migration qu’une fois la migration terminée.