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.
All products
Migrations

Récupération de mannequins pour GitHub Enterprise Importer

Dans cet article

Après votre migration, vous pouvez affecter l’historique d’une identité d’espace réservé, ou mannequin, à un membre de votre organisation.

Qui peut utiliser cette fonctionnalité

Organization owners can reclaim mannequins.

Remarque : GitHub Enterprise Importer est actuellement en version bêta publique et peut faire l’objet de modifications.

À propos des mannequins

Après avoir exécuté une migration avec GitHub Enterprise Importer, toutes les activités utilisateur dans le dépôt migré (à l’exception des commits Git) sont attribuées à des identités d’espace réservé appelées mannequins.

Chaque mannequin a uniquement un nom d’affichage, qui provient du nom d’affichage dans le dépôt source. Les mannequins n’ont pas d’appartenance à l’organisation ou d’accès au dépôt. Les mannequins utilisent toujours le même avatar, un octocat fantôme, et incluent une étiquette mannequin qui suit le nom d’affichage.

Capture d’écran de l’en-tête d’un commentaire de problème. Le commentateur est étiqueté mannequin, et l’étiquette « Mannequin » est encadré en orange foncé.

Vous pouvez réattribuer l’historique de chaque mannequin à un membre de l’organisation en envoyant une invitation d’attribution avec GitHub CLI ou dans votre navigateur. Si vous utilisez GitHub CLI, vous pouvez récupérer des mannequins en bloc. Vous pouvez également afficher l’état de toutes les invitations d’attribution. Une fois que la personne accepte l’invitation, le mannequin est récupéré.

La récupération est facultative et peut se produire à tout moment après la fin d’une migration. C’est pourquoi vous pouvez autoriser votre équipe à commencer à travailler dans les dépôts migrés avant de procéder à la récupération.

Les mannequins ne sont pas utilisés pour l’attribution de commits Git. Pour plus d’informations sur l’attribution de commits, consultez « Gestion de la création de commits » ci-dessous.

Récupération de mannequins

Vous pouvez récupérer un mannequin en envoyant une invitation d’attribution à un membre d’organisation, avec GitHub CLI ou dans votre navigateur.

Remarque : Vous pouvez uniquement envoyer des invitations d’attribution aux membres d’organisation. Avant de tenter de récupérer un mannequin, vérifiez que l’utilisateur GitHub que vous souhaitez inviter est déjà ajouté à l’organisation.

Le membre peut choisir d’accepter ou de refuser l’invitation. Une fois qu’un membre accepte une invitation d’attribution, toutes les contributions précédemment attribuées au mannequin sont attribuées au membre à la place. Dans les futures migrations vers la même organisation, toutes les contributions du même mannequin seront automatiquement récupérées pour ce même membre.

GitHub Enterprise Importer ne migre pas l’accès utilisateur vers les dépôts. Après avoir récupérer les mannequins, si l’un des membres ne dispose pas déjà d’un accès approprié au dépôt via son appartenance à l’équipe, vous devez lui donner l’accès au dépôt séparément. Pour plus d’informations, consultez « Gestion de l’accès d’une personne à un dépôt d’organisation ».

Vous pouvez récupérer des mannequins avec GitHub CLI (recommandé) ou le navigateur.

Récupération de mannequins avec GitHub CLI (recommandé)

Vous pouvez utiliser GitHub CLI pour récupérer des mannequins individuellement ou en bloc. Pour plus d’informations sur l’installation et la mise à jour des extensions de migration pour GitHub CLI, consultez « Migration de dépôts avec GitHub Enterprise Importer ».

La commande exacte que vous devez utiliser dépend de l’extension de GitHub CLI que vous utilisez.

Récupération de mannequins avec l’GEI extension

Si votre source de migration est un produit GitHub, vous pouvez récupérer des mannequins avec l’GEI extension of the GitHub CLI.

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 à chacune des commandes ci-dessous, 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 ».

  1. Si vous le souhaitez, pour récupérer des mannequins en bloc, créez un fichier CSV qui mappe les mannequins aux membres de l’organisation.

    • Pour générer un fichier CSV avec une liste de mannequins d’une organisation, utilisez la commande gh gei generate-mannequin-csv en remplaçant DESTINATION par l’organisation de destination et FILENAME par un nom de fichier pour le fichier CSV résultant.

      Si vous le souhaitez, pour inclure les mannequins qui ont déjà été récupérés, ajoutez l’indicateur --include-reclaimed.

      Shell
      gh gei generate-mannequin-csv --github-target-org DESTINATION --output FILENAME.csv

    • Modifiez le fichier CSV en ajoutant le nom d’utilisateur du membre de l’organisation qui correspond à chaque mannequin.

    • Enregistrez le fichier .

  2. Pour récupérer des mannequins, utilisez la commande gh gei reclaim-mannequin.

    • Pour récupérer des mannequins en bloc avec le fichier de mappage que vous avez créé précédemment, remplacez DESTINATION par l’organisation de destination et FILENAME par le nom du fichier de mappage.

      Shell
      gh gei reclaim-mannequin --github-target-org DESTINATION --csv FILENAME.csv

    • Pour récupérer un mannequin individuel, remplacez DESTINATION par l’organisation de destination, MANNEQUIN par la connexion du mannequin et USERNAME par le nom d’utilisateur du membre de l’organisation qui correspond au mannequin.

      S’il existe plusieurs mannequins avec la même connexion, vous pouvez remplacer --mannequin-user MANNEQUIN par --mannequin-ID ID, en remplaçant ID par l’ID du mannequin.

      Shell
      gh gei reclaim-mannequin --github-target-org DESTINATION --mannequin-user MANNEQUIN --target-user USERNAME

  3. Le membre de l’organisation recevra une invitation par e-mail, et le mannequin ne sera pas récupéré tant que le membre n’aura pas accepté l’invitation.

Récupération de mannequins avec l’ADO2GH extension

Si votre source de migration est Azure DevOps, vous pouvez récupérer des mannequins avec l’ADO2GH extension of the GitHub CLI.

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 à chacune des commandes ci-dessous, 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 ».

  1. Si vous le souhaitez, pour récupérer des mannequins en bloc, créez un fichier CSV qui mappe les mannequins aux membres de l’organisation.

    • Pour générer un fichier CSV avec une liste de mannequins d’une organisation, utilisez la commande gh ado2gh generate-mannequin-csv en remplaçant DESTINATION par l’organisation de destination et FILENAME par un nom de fichier pour le fichier CSV résultant.

      Si vous le souhaitez, pour inclure les mannequins qui ont déjà été récupérés, ajoutez l’indicateur --include-reclaimed.

      Shell
      gh ado2gh generate-mannequin-csv --github-org DESTINATION --output FILENAME.csv

    • Modifiez le fichier CSV en ajoutant le nom d’utilisateur du membre de l’organisation qui correspond à chaque mannequin.

    • Enregistrez le fichier .

  2. Pour récupérer des mannequins, utilisez la commande gh ado2gh reclaim-mannequin.

    • Pour récupérer des mannequins en bloc avec le fichier de mappage que vous avez créé précédemment, remplacez DESTINATION par l’organisation de destination et FILENAME par le nom du fichier de mappage.

      Shell
      gh ado2gh reclaim-mannequin --github-org DESTINATION --csv FILENAME.csv

    • Pour récupérer un mannequin individuel, remplacez DESTINATION par l’organisation de destination, MANNEQUIN par la connexion du mannequin et USERNAME par le nom d’utilisateur du membre de l’organisation qui correspond au mannequin.

      S’il existe plusieurs mannequins avec la même connexion, vous pouvez remplacer --mannequin-user MANNEQUIN par --mannequin-ID ID, en remplaçant ID par l’ID du mannequin.

      Shell
      gh ado2gh reclaim-mannequin --github-org DESTINATION --mannequin-user MANNEQUIN --target-user USERNAME

  3. Le membre de l’organisation recevra une invitation par e-mail, et le mannequin ne sera pas récupéré tant que le membre n’aura pas accepté l’invitation.

Récupération de mannequins dans votre navigateur

  1. Dans l’angle supérieur droit de GitHub.com, cliquez sur votre photo de profil, puis sur Vos organisations.

    Capture d’écran du menu déroulant sous l’image de profil de @octocat. « Vos organisations » est présenté en orange foncé. 2. En regard de l’organisation, cliquez sur Paramètres.

    Capture d’écran de l’organisation « octo-org » avec le bouton « Paramètres » mis en évidence avec un contour orange foncé. 1. Dans la section « Accès » de la barre latérale, cliquez sur Importer/exporter.

  2. À droite du mannequin que vous souhaitez récupérer, cliquez sur Réattribuer.

  3. Dans le champ de recherche, tapez le nom d’utilisateur du membre d’organisation auquel vous souhaitez attribuer les contributions du mannequin, puis cliquez sur le membre.

    Remarque : Vous pouvez uniquement envoyer des invitations d’attribution aux comptes d’utilisateur qui sont déjà membres de l’organisation.

  4. Cliquez sur Invite.

  5. Le membre de l’organisation recevra une invitation par e-mail, et le mannequin ne sera pas récupéré tant que le membre n’aura pas accepté l’invitation.

Affichage de l’état de vos invitations d’attribution

Vous pouvez afficher l’état de toutes les invitations d’attribution pour votre organisation.

  • Invité : L’utilisateur n’a pas encore répondu à l’invitation.
  • Terminé : L’utilisateur a accepté et ses contributions ont été réattribuées.
  • Refusé : L’utilisateur a choisi de ne pas être crédité pour les contributions du mannequin.

  1. Dans l’angle supérieur droit de GitHub.com, cliquez sur votre photo de profil, puis sur Vos organisations.

    Capture d’écran du menu déroulant sous l’image de profil de @octocat. « Vos organisations » est présenté en orange foncé. 2. En regard de l’organisation, cliquez sur Paramètres.

    Capture d’écran de l’organisation « octo-org » avec le bouton « Paramètres » mis en évidence avec un contour orange foncé. 1. Dans la section « Accès » de la barre latérale, cliquez sur Importer/exporter.

  2. Sous «  Importer/exporter », cliquez sur Invitations d’attribution.

    Capture d’écran de la page « Importer/exporter » d’un dépôt. Un onglet intitulé « Invitations d’attribution » est encadré en orange foncé.

Gestion de la création de commits Git

La création de commits Git n’est pas associée aux mannequins et ne peut pas être attribuée aux utilisateurs GitHub en récupérant des mannequins. Au lieu de cela, la création de commits est attribuée aux comptes d’utilisateur dans GitHub sur la base de l’adresse e-mail qui a été utilisée pour créer le commit dans Git.

Dans de nombreux cas, les utilisateurs peuvent se réattribuer des commits en ajoutant l’adresse e-mail utilisée pour créer le commit à leur compte d’utilisateur dans GitHub. Pour plus d’informations, consultez « Ajout d’une adresse e-mail à votre compte GitHub ».

Toutefois, si vous utilisez Enterprise Managed Users, les utilisateurs ne peuvent pas ajouter d’adresses e-mail à leur compte d’utilisateur dans GitHub et ne peuvent donc pas se réattribuer des commits Git. Seuls les commits créés par l’adresse e-mail principale d’un utilisateur dans votre fournisseur d’identité (IdP) sont attribués à comptes d’utilisateur managés.

De plus, les commits créés par une adresse e-mail noreply fournie par GitHub ne peuvent pas être réattribués, car vous ne pouvez pas ajouter manuellement d’adresse e-mail noreply à un compte d’utilisateur. Pour plus d’informations, consultez « Définition de votre adresse e-mail de commit ».