Récupération de modèles pour GitHub Enterprise Importer

          Après avoir exécuté une migration avec GitHub Enterprise Importer ou Enterprise Live Migrations, toutes les activités utilisateur dans le référentiel migré (à l’exception des validations Git) sont attribuées aux identités d’espace réservé appelées mannequins. Pour plus d’informations, consultez [AUTOTITLE](/migrations/overview/mannequins-and-user-activity).

Récupération de mannequins

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

• Récupérer les mannequins avec le GitHub CLI (recommandé)
• Récupération de mannequins dans votre navigateur

          GitHub Enterprise Importer ne migre pas l’accès utilisateur aux référentiels. Après avoir récupérer les mannequins, si l’un des utilisateurs ne dispose pas déjà d’un accès approprié au référentiel via son appartenance à l’équipe, vous devez lui donner l’accès au référentiel séparément. Pour plus d’informations, consultez [Gestion de l’accès d’une personne à un référentiel d’organisation](/organizations/managing-access-to-your-organizations-repositories/managing-an-individuals-access-to-an-organization-repository).

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

Vous pouvez utiliser le GitHub CLI pour réclamer des mannequins individuellement ou en grande quantité. Pour plus d’informations sur l’installation et la mise à jour des extensions de migration pour GitHub CLI, consultez À propos de GitHub Enterprise Importer.

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

• Récupérer des mannequins avec les GEI extension
• Récupérer des mannequins avec les ADO2GH extension
• Réhabiliter des mannequins avec les BBS2GH extension

Récupérer les mannequins avec le GEI extension

Si votre source de migration est un GitHub produit, vous pouvez récupérer des mannequins avec le 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 personal access token connaître les conditions requises, consultez Gestion de l’accès pour une migration entre des 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.

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.

     Si votre organisation utilise Enterprise Managed Users et que vous souhaitez ignorer l’invitation d’attribution pour récupérer immédiatement le mannequin, ajoutez l’argument --skip-invitation.

     Shell

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

Par défaut, 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 ADO2GH extension

Si votre source de migration est Azure DevOps, vous pouvez récupérer des mannequins avec le 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.

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

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.

     Si votre organisation utilise Enterprise Managed Users et que vous souhaitez ignorer l’invitation d’attribution pour récupérer immédiatement le mannequin, ajoutez l’argument --skip-invitation.

     Shell

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

Par défaut, 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érer les mannequins avec le BBS2GH extension

Si votre source de migration est Bitbucket Server, vous pouvez récupérer des mannequins avec le BBS2GH 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 personal access token connaître les conditions requises, 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.

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

     Si votre organisation utilise Enterprise Managed Users et que vous souhaitez ignorer l’invitation d’attribution pour récupérer immédiatement le mannequin, ajoutez l’argument --skip-invitation.

     Shell

     gh bbs2gh reclaim-mannequin --github-org DESTINATION --mannequin-user MANNEQUIN --target-user USERNAME
     

Par défaut, 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 le coin supérieur droit de GitHub, cliquez sur votre photo de profil, puis sur Vos organisations.

2. Sélectionnez une organisation en cliquant dessus.

3. Sous le nom de votre organisation, cliquez sur Settings. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.

   

4. Dans la section « Accès » de la barre latérale, cliquez sur Importer/exporter.

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

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

7. Cliquez sur Invite. Par défaut, 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 a reçu une invitation, mais n'y a pas encore répondu.
• Terminé : l’utilisateur a accepté ou le processus d’invitation a été ignoré. Les contributions de l’utilisateur ont été réattribuées.
• Refusé : L’utilisateur a choisi de ne pas être crédité pour les contributions du mannequin.

1. Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil, puis sur Vos organisations.

2. Sélectionnez une organisation en cliquant dessus.

3. Sous le nom de votre organisation, cliquez sur Settings. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.

   

4. Dans la section « Accès » de la barre latérale, cliquez sur Importer/exporter.

5. Sous « Import/Export », cliquez sur Invitations d’attribution.

   

Gestion de l'attribution des commits Git

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

Dans de nombreux cas, les utilisateurs peuvent réattribuer eux-mêmes les validations en ajoutant l’adresse e-mail utilisée pour créer la validation sur leur compte GitHubd’utilisateur. Pour plus d’informations, consultez « Ajout d’une adresse e-mail à votre compte de GitHub ».

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

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