Skip to main content
Skip to content

Migrate your repositories from Azure DevOps to GitHub

Perform a trial run and then migrate your repositories from Azure DevOps to GitHub.

Prerequisites

  • You must have completed all previous phases of this guide.
  • Certifique-se de entender os dados que serão migrados e as limitações de suporte conhecidas do Importador. For more information, see Understand migrations from Azure DevOps to GitHub.
  • Embora não seja necessário, recomendamos interromper o trabalho durante a migração de produção. O Importer não dá suporte a migrações delta, ou seja, as alterações que ocorrerem durante a migração não serão migradas. Se você optar por não interromper o trabalho durante a migração de produção, precisará migrar manualmente essas alterações.

Generate a migration script

Caso você deseje migrar vários repositórios para o GitHub Enterprise Cloud ao mesmo tempo, use a GitHub CLI para gerar um script de migração. O script resultante conterá uma lista de comandos de migração, um por repositório.

Observação

Gerar um script produz um script do PowerShell. Se você estiver usando o Terminal, precisará gerar o script com a extensão de arquivo .ps1 e instalar o PowerShell para Mac ou Linux para executá-lo.

To generate a migration script, run the gh ado2gh generate-script command.

Shell
gh ado2gh generate-script --ado-org SOURCE --github-org DESTINATION --output FILENAME

Substitua os espaços reservados no comando acima pelos valores a seguir.

Espaço reservadoValor
SOURCENome da organização de origem
DESTINATIONNome da organização de destino
FILENAMEUm nome de arquivo para o script de migração resultante

Se estiver usando o Terminal, use uma extensão de arquivo .ps1, pois o script gerado exige a execução do PowerShell. Você pode instalar o PowerShell para Mac ou Linux.

Additional arguments

ArgumentDescription
--target-api-url TARGET-API-URLSe você estiver migrando para o GHE.com, adicione --target-api-url TARGET-API-URL, em que TARGET-API-URL é a URL da API base para o subdomínio da sua empresa. Por exemplo: https://api.octocorp.ghe.com.
--allAdd additional functionality to the script, such as rewiring pipelines, creating teams, and configuring Azure Boards integrations.
--download-migration-logsDownload the migration log for each migrated repository. For more information about migration logs, see Como acessar os logs de migração do GitHub Enterprise Importer.

Reviewing the migration script

Depois de gerar o script, analise o arquivo e, opcionalmente, edite o script.

  • Se houver repositórios que você não deseja migrar, exclua ou comente as linhas correspondentes.
  • Caso você deseje que algum repositório tenha um nome diferente na organização de destino, atualize o valor do sinalizador --target-repo correspondente.
  • Se você quiser alterar a visibilidade de um novo repositório, atualize o valor do sinalizador correspondente --target-repo-visibility . Por padrão, o script define a mesma visibilidade que o repositório de origem.

Perform a trial run

Para ajudar a descobrir problemas que podem ser exclusivos da sua empresa, é altamente recomendável realizar um teste de migração. Com uma versão de teste, você aprenderá:

  • Se a migração para um determinado repositório pode ser concluída com êxito.
  • Se você pode obter o repositório migrado de volta para um estado viável.
  • Quanto tempo uma migração levará para ser executada.

Testes práticos podem ocorrer a qualquer momento, e o trabalho não precisa ser interrompido durante a migração. Para reduzir o tempo necessário para concluir suas migrações de teste, você pode agendar os lotes para suas execuções de teste uma após a outra. Os usuários desses repositórios podem validar os resultados no seu próprio tempo.

  1. Create a test organization for your trial migrations.

    You can use a single organization for all trial runs, or you can create one test organization for each intended destination organization. Consider including -sandbox at the end of the organization names, to clarify that the organizations are intended only for migration validation and not for production. You can delete the test organizations after you're done.

  2. Run the trial migrations.

  3. Confirm that you are able to complete the follow-up tasks in Follow-up tasks.

  4. Ask users to validate the results of the migrations.

  5. Resolve any issues uncovered by your trial migrations.

  6. Opcionalmente, exclua a organização de teste.

Migrate repositories

If your trial run was successful, and you were able to complete the follow-up tasks, you can proceed to the real migration.

Aviso

We recommend halting work in the repositories you are migrating. Any changes made during or after the migration will need to be manually migrated.

Para migrar vários repositórios, execute o script gerado. Substitua FILENAME nos comandos abaixo pelo nome do arquivo que você forneceu ao gerar o script.

  • Se estiver usando o Terminal, use ./.

    Shell
    ./FILENAME
    
  • Se estiver usando o PowerShell, use .\.

    Shell
    .\FILENAME