Granting the migrator role

To allow someone other than an organization owner to run a migration or download migration logs, you can grant the migrator role to a user or team.

To grant the migrator role using the CLI, you can use the GL2GH extension of the GitHub CLI.

1. Install the GitHub CLI.

   • A fin de obtener instrucciones de instalación para GitHub CLI, vea el repositorio de GitHub CLI.
   • If you already have GitHub CLI installed, run gh --version to ensure you're running version 2.4.0 or newer. If you have an older version, visit the GitHub CLI repository for upgrade instructions.

2. Install the GL2GH extension.

   Shell

   gh extension install github/gh-gl2gh
   

3. The GL2GH extension of the GitHub CLI is updated frequently. Para asegurarte de que usas la versión más reciente, actualiza la extensión.

   Shell

   gh extension upgrade github/gh-gl2gh
   

4. On GitHub, create and record a personal access token that has the admin:org scope.

5. Establece personal access token como una variable de entorno, y reemplaza TOKEN en los comandos siguientes por el valor personal access token que has registrado antes.

   • Si usas Terminal, utiliza el comando export.

     Shell

     export GH_PAT="TOKEN"
     

   • Si usas PowerShell, utiliza el comando $env.

     Shell

     $env:GH_PAT="TOKEN"
     

6. Use the gh gl2gh grant-migrator-role command, replacing ORGANIZATION with the organization you want to grant the migrator role for, ACTOR with the user or team name, and TYPE with USER or TEAM.

   Shell

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

   Nota:

   Si vas a conceder el rol de migración para GHE.com, también debes incluir la dirección URL de la API de destino para el subdominio de la empresa. Por ejemplo: --target-api-url https://api.octocorp.ghe.com.