Skip to main content

Concedendo a função de migrador

A função migradora oferece a um usuário ou equipe a capacidade de executar migrações em nome de uma organização.

Para permitir que alguém que não seja um proprietário da organização execute uma migração ou faça download de logs de migração, você pode conceder a função de migrador a um usuário ou equipe.

Para conceder a função de migrador usando a CLI, você pode usar o ADO2GH extension of the GitHub CLI.

  1. Instale os GitHub CLI.

    • Para obter instruções de instalação para GitHub CLI, veja o repositório GitHub CLI.
    • Se você já tiver GitHub CLI instalado, execute gh --version para garantir que esteja executando a versão 2.4.0 ou mais recente. Se você tiver uma versão mais antiga, visite o GitHub CLI repositório para obter instruções de atualização.
  2. Instale os ADO2GH extension.

    Shell
    gh extension install github/gh-ado2gh
    
  3. O ADO2GH extension of the GitHub CLI é atualizado semanalmente. Para garantir que você esteja usando a última versão, atualize a extensão.

    Shell
    gh extension upgrade github/gh-ado2gh
    
  4. Em GitHub, crie e registre um personal access token que tenha o escopo admin:org scope.

  5. Defina o personal access token como uma variável de ambiente, substituindo TOKEN nos comandos abaixo pelos personal access token que você registrou acima.

    • Se você estiver usando o Terminal, use o comando export.

      Shell
      export GH_PAT="TOKEN"
      
    • Se você estiver usando o PowerShell, use o comando $env.

      Shell
      $env:GH_PAT="TOKEN"
      
  6. Use o comando gh ado2gh grant-migrator-role, substituindo ORGANIZATION pela organização à qual você deseja conceder a função de migrador, ACTOR pelo nome do usuário ou da equipe e TYPE por USER ou TEAM.

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

    Observação

    Se você estiver concedendo a função de migrador para o GHE.com, também precisará incluir a URL de API de destino para o subdomínio da sua empresa. Por exemplo: --target-api-url https://api.octocorp.ghe.com.