Octroi du rôle de migrateur

Pour permettre à une personne autre que le propriétaire de l'organisation d'exécuter une migration ou de télécharger les journaux de migration, vous pouvez octroyer le rôle de migrateur à un utilisateur ou à une équipe.

Pour accorder le rôle de migrateur à l’aide du CLI, vous pouvez utiliser les données ADO2GH extension of the GitHub CLI.

1. Installez GitHub CLI. *

   • Si vous avez déjà GitHub CLI installé, exécutez gh --version pour vous assurer que vous exécutez la version 2.4.0 ou ultérieure. Si vous avez une version antérieure, visitez le référentiel GitHub CLI pour obtenir des instructions de mise à niveau.

2. Installez ADO2GH extension.

   Shell

   gh extension install github/gh-ado2gh
   

3. ADO2GH extension of the GitHub CLI est mis à jour toutes les semaines.

   Shell

   gh extension upgrade github/gh-ado2gh
   

4. Sur GitHub, créez et enregistrez un personal access token qui a l’étendue admin:org.

5. Définissez le personal access token comme variable d’environnement, en remplaçant TOKEN dans les commandes ci-dessous par le personal access token que vous avez enregistré ci-dessus.

   • Si vous utilisez le Terminal, utilisez la commande export.

     Shell

     export GH_PAT="TOKEN"
     

   • Si vous utilisez PowerShell, utilisez la commande $env.

     Shell

     $env:GH_PAT="TOKEN"
     

6. Utilisez la commande gh ado2gh grant-migrator-role en remplaçant ORGANIZATION par l’organisation pour laquelle vous souhaitez accorder le rôle de migrateur, ACTOR par le nom d’utilisateur ou d’équipe et TYPE par USER ou TEAM.

   Shell

   gh ado2gh grant-migrator-role --github-org ORGANIZATION --actor ACTOR --actor-type TYPE
   

   Remarque

   Si vous accordez le rôle de migrateur à GHE.com, vous devez également inclure l'URL de l'API cible pour le sous-domaine de votre entreprise. Par exemple : --target-api-url https://api.octocorp.ghe.com.