Como conceder a função de migrador ao GitHub Enterprise Importer

Sobre a função de migrador

Para remover a necessidade de os proprietários da organização concluírem as migrações, o GitHub.com inclui uma função distinta para usar o GitHub Enterprise Importer. A concessão da função de migrador permite designar outras equipes ou pessoas para lidar com as migrações.

Você pode conceder a função de migrador a um usuário individual ou a uma equipe. Recomendamos fortemente que você atribua a função de migrador a uma equipe. Em seguida, você poderá personalizar ainda mais quem pode executar uma migração ajustando a associação à equipe. Para obter mais informações sobre como alterar a associação à equipe, confira "Adicionar integrantes da organização a uma equipe" ou "Remover integrantes da organização de uma equipe".

Você só pode conceder a função de migrador a uma organização do GitHub.com. Se você estiver migrando um repositório entre duas organizações do GitHub.com, poderá conceder a função de migrador à mesma pessoa ou equipe para as duas organizações, mas precisará conceder cada uma separadamente.

Observação: não é possível conceder a função de migrador para contas corporativas. Portanto, você só poderá executar uma migração da organização se for proprietário da empresa de destino. No entanto, você pode conceder a função de migrador a esse proprietário da empresa para a organização de origem.

Depois de conceder a função de migrador, verifique se o migrador usa um personal access token que atenda a todos os requisitos para executar migrações. Para obter os detalhes desses requisitos, confira "Como gerenciar o acesso do GitHub Enterprise Importer".

To see instructions for using the API, use the tool switcher at the top of the page.

Como conceder a função de migrador com a ADO2GH extension

No GitHub.com, crie e registre um personal access token que atenda a todos os requisitos para conceder a função de migrador. Para ver a lista completa de requisitos, confira "Como gerenciar o acesso do GitHub Enterprise Importer".
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"
```
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
```

Como conceder a função de migrador com a BBS2GH extension

Observação: As migrações do Bitbucket Server usando o GitHub Enterprise Importer estão atualmente em beta privado e sujeitas a alterações. Para solicitar acesso à versão beta, confira Entrar na lista de espera de migrações do Bitbucket Server.

No GitHub.com, crie e registre um personal access token que atenda a todos os requisitos para conceder a função de migrador. Para ver a lista completa de requisitos, confira "Como gerenciar o acesso do GitHub Enterprise Importer".
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"
```
Use o comando gh bbs2gh 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 bbs2gh grant-migrator-role --github-org ORGANIZATION --actor ACTOR --actor-type TYPE
```

Como conceder a função de migrador com a GEI extension

Observação: a GitHub CLI não dá suporte à concessão da função de migrador para organizações do GitHub Enterprise Server, ou seja, você precisa ser um proprietário da organização de origem para migrar repositórios do GitHub Enterprise Server.

No GitHub.com, crie e registre um personal access token que atenda a todos os requisitos para conceder a função de migrador. Para ver a lista completa de requisitos, confira "Como gerenciar o acesso do GitHub Enterprise Importer".
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"
```
Use o comando gh gei 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 gei grant-migrator-role --github-org ORGANIZATION --actor ACTOR --actor-type TYPE
```

Para ver instruções para usar os dados da GitHub CLI, use o alternador de ferramentas na parte superior da página.

Como conceder a função de migrador com a API do GraphQL

Use a mutação grantMigratorRole do GraphQL para atribuir a função de migrador e a mutação revokeMigratorRole para revogar a função de migrador.

Você precisa usar um PAT (personal access token) que atenda a todos os requisitos de acesso. Para obter mais informações, confira "Como gerenciar o acesso do GitHub Enterprise Importer".

Mutação `grantMigratorRole`

Essa mutação do GraphQL define a função de migração.

mutation grantMigratorRole (
  $organizationId: ID!,
  $actor: String!,
  $actor_type: ActorType!
) {
  grantMigratorRole( input: {
    organizationId: $organizationId,
    actor: $actor,
    actorType: $actor_type
  })
   { success }
}

Variável da consulta	Descrição
`organizationId`	A `ownerId` (ou ID da organização) para sua organização, da consulta `GetOrgInfo`.
`actor`	O nome da equipe ou do usuário ao qual você deseja atribuir a função de migração.
`actor_type`	Especifique se o migrador é um `USER` ou uma `TEAM`.

Mutação `revokeMigratorRole`

Essa mutação remove a função de migrador.

mutation revokeMigratorRole (
  $organizationId: ID!,
  $actor: String!,
  $actor_type: ActorType!
) {
  revokeMigratorRole( input: {
    organizationId: $organizationId,
    actor: $actor,
    actorType: $actor_type
  })
   { success }
}