# Gerenciar o acesso para uma migração do GitLab para o GitHub

Configure o acesso necessário para migrar do GitLab para GitHub.

Para migrar repositórios do GitLab para GitHub, você precisa de acesso suficiente à **origem** (um projeto no GitLab) e ao **destino** (uma organização em GitHub). Depois de concluir as etapas neste artigo, seu acesso e permissões estarão prontos para sua migração.

## Decidir quem executará a migração

Se a pessoa que executará a migração **não** for uma GitHub proprietária da organização, o GitHub proprietário da organização deverá primeiro conceder a ela a função de migrador.

* Se você for um GitHub proprietário da organização e pretende executar a migração por conta própria, poderá continuar lendo este guia.
* Se você quiser atribuir a função de migrador a outra pessoa, faça isso agora. Em seguida, o migrador deve executar as etapas restantes nestes guias. Consulte [Concedendo o papel de migrador](/pt/migrations/using-github-enterprise-importer/migrate-from-gitlab/grant-the-migrator-role).

## Criar um personal access token (classic) em GitHub

Em seguida, você precisará criar um personal access token (classic) que o GL2GH extension of the GitHub CLI usará para se comunicar com GitHub. Os escopos necessários para sua GitHubpersonal access token (classic) função dependem da função e da tarefa que você deseja concluir.

> \[!NOTE]
> Você só pode usar um personal access token (classic), não um fine-grained personal access token. Isso significa que você não poderá usar GitHub Enterprise Importer se sua organização usar a política "Restringir personal access tokens (classic) o acesso às suas organizações". Para saber mais, confira [Como impor políticas para tokens de acesso pessoal na empresa](/pt/enterprise-cloud@latest/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-personal-access-tokens-in-your-enterprise#restricting-access-by-personal-access-tokens).

| Tarefa                                                             | Proprietário da organização                                                                                                                                                                                                          | Migrador                                                                                                                                                                                                                             |
| ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Como atribuir a função de migrador para migrações de repositório   | `admin:org`                                                                                                                                                                                                                          | <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-dash" aria-label="Not applicable" role="img"><path d="M2 7.75A.75.75 0 0 1 2.75 7h10a.75.75 0 0 1 0 1.5h-10A.75.75 0 0 1 2 7.75Z"></path></svg> |
| Como executar uma migração de repositório (organização de destino) |                                                                                                                                                                                                                                      |                                                                                                                                                                                                                                      |
| `repo`, , `workflow``admin:org`                                    |                                                                                                                                                                                                                                      |                                                                                                                                                                                                                                      |
| `repo`, , `workflow``read:org`                                     |                                                                                                                                                                                                                                      |                                                                                                                                                                                                                                      |
| Como baixar um log de migração                                     |                                                                                                                                                                                                                                      |                                                                                                                                                                                                                                      |
| `repo`, , `workflow``admin:org`                                    |                                                                                                                                                                                                                                      |                                                                                                                                                                                                                                      |
| `repo`, , `workflow``read:org`                                     |                                                                                                                                                                                                                                      |                                                                                                                                                                                                                                      |
| Como recuperar manequins                                           |                                                                                                                                                                                                                                      |                                                                                                                                                                                                                                      |
| `repo`, , `workflow``admin:org`                                    | <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-dash" aria-label="Not applicable" role="img"><path d="M2 7.75A.75.75 0 0 1 2.75 7h10a.75.75 0 0 1 0 1.5h-10A.75.75 0 0 1 2 7.75Z"></path></svg> |                                                                                                                                                                                                                                      |

Para saber como criar o token, consulte [Gerenciar seus tokens de acesso pessoal](/pt/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#creating-a-personal-access-token-classic).

## Criar um personal access token no GitLab

O GitLab personal access token deve ter os escopos e `read_repository` os `api` escopos.

Para instâncias do GitLab autogerenciadas, o token deve pertencer a um **administrador**, para que a exportação seja concluída e a atribuição do usuário seja preservada.

Para saber como criar o token, consulte [Personal access tokens](https://docs.gitlab.com/user/profile/personal_access_tokens/) a documentação do GitLab.

## Configurar listas de permissão de IP em GitHub

Se você usar GitHubo recurso de lista de permissões de IP, deverá adicionar os GitHub intervalos de IP abaixo à lista de permissões para a organização de destino. Confira [Gerenciar endereços IP permitidos para sua organização](/pt/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization) ou [Como restringir o tráfego de rede para sua empresa com uma lista de permissões de IP](/pt/enterprise-cloud@latest/admin/configuring-settings/hardening-security-for-your-enterprise/restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list).

Se sua organização de destino estiver ativada **GitHub.com**, você precisará permitir os seguintes endereços IP:

* 192.30.252.0/22
* 185.199.108.0/22
* 140.82.112.0/20
* 143.55.64.0/20
* 135.234.59.224/28 (adicionado em 28 de julho de 2025)
* 2a0a:a440::/29
* 2606:50c0::/32
* 20.99.172.64/28 (adicionado em 28 de julho de 2025)

Se sua organização de destino estiver ativada **GHE.com**, os intervalos que você precisa permitir dependem da sua região de residência de dados. Você pode obter uma lista de datas up-tode intervalos de IP usados GitHub Enterprise Importer com o `/meta` ponto de extremidade da API REST. A chave `github_enterprise_importer` na resposta contém uma lista de intervalos de IP usados para as migrações.

## Permitir que as migrações ignorem os conjuntos de regras do repositório

Se a organização de destino ou a empresa tiver conjuntos de regras habilitados, o histórico do repositório migrado poderá violar essas regras. Para permitir a migração sem desabilitar seus conjuntos de regras, adicione "Migrações de repositório" à lista de bypass para cada conjunto de regras aplicável.  Esse bypass se aplica somente durante a migração. Após a conclusão, os conjuntos de regras serão aplicados em todas as novas contribuições.

Para configurar o bypass:

1. Navegue até cada conjunto de regras da empresa ou da organização.
2. Na seção "Lista de bypass", clique em **Adicionar bypass**.
3. Selecione **migrações de repositório**.

Para obter mais informações, consulte [Criar conjuntos de regras para repositórios na sua organização](/pt/organizations/managing-organization-settings/creating-rulesets-for-repositories-in-your-organization) e [Configuração de exceções de regras para migrações de repositório](/pt/enterprise-cloud@latest/migrations/troubleshooting/setting-ruleset-bypasses-for-repository-migrations).

## Habilitar exportações no GitLab

Os projetos do GitLab que você deseja migrar devem estar habilitados para exportações. Consulte [Habilitar a exportação de projeto](https://docs.gitlab.com/administration/settings/import_and_export_settings/#enable-project-export) e a [configuração do Sidekiq para importações](https://docs.gitlab.com/administration/sidekiq/configuration_for_imports/) na documentação do GitLab.