Skip to main content
Nous publions des mises à jour fréquentes de notre documentation, et la traduction de cette page peut encore être en cours. Pour obtenir les informations les plus actuelles, consultez la documentation anglaise.

Cette version de GitHub Enterprise a été abandonnée le 2023-03-15. Aucune publication de correctifs n’est effectuée, même pour les problèmes de sécurité critiques. Pour de meilleures performances, une sécurité améliorée et de nouvelles fonctionnalités, effectuez une mise à niveau vers la dernière version de GitHub Enterprise. Pour obtenir de l’aide sur la mise à niveau, contactez le support GitHub Enterprise.

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

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

Shell
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

Remarque : Les migrations à partir de Bitbucket Server utilisant GitHub Enterprise Importer sont actuellement en version bêta privée et sont susceptibles être modifiées. Pour demander l’accès à la version bêta, consultez Rejoindre la liste d’attente des migrations Bitbucket Server.

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.

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

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

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.