Skip to main content

Concesión del rol de migrador

El rol de migración ofrece a un usuario o equipo la capacidad de ejecutar migraciones en nombre de una organización.

Para permitir que alguien que no sea propietario de la organización ejecute una migración o descargue registros de migración, puedes conceder el rol de migración a un usuario o equipo.

Para conceder el rol de migrador usando la CLI, puede usar ADO2GH extension of the GitHub CLI.

  1. Instala el GitHub CLI.

    • A fin de obtener instrucciones de instalación para GitHub CLI, vea el repositorio de GitHub CLI.
    • Si ya tiene GitHub CLI instalados, ejecute gh --version para asegurarse de que está ejecutando la versión 2.4.0 o posterior. Si tiene una versión anterior, visite el repositorio GitHub CLI para obtener instrucciones de actualización.
  2. Instalación de ADO2GH extension.

    Shell
    gh extension install github/gh-ado2gh
    
  3. ADO2GH extension of the GitHub CLI se actualiza semanalmente. Para asegurarte de que usas la versión más reciente, actualiza la extensión.

    Shell
    gh extension upgrade github/gh-ado2gh
    
  4. En GitHub, cree un personal access token que tenga el admin:org ámbito y registrelo.

  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. Usa el comando gh ado2gh grant-migrator-role, y reemplaza ORGANIZATION por la organización a la que quieras conceder el rol de migración, ACTOR por el nombre de usuario o equipo, y TYPE por USER o TEAM.

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