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.
gh ado2gh generate-script --ado-org SOURCE --github-org DESTINATION --output FILENAME
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 reservado | Valor |
|---|---|
| SOURCE | Nome da organização de origem |
| DESTINATION | Nome da organização de destino |
| FILENAME | Um 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
| Argument | Description |
|---|---|
--target-api-url TARGET-API-URL | Se 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:/. |
--all | Add additional functionality to the script, such as rewiring pipelines, creating teams, and configuring Azure Boards integrations. |
--download-migration-logs | Download 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-repocorrespondente. - 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.
-
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
-sandboxat 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. -
Run the trial migrations.
-
Confirm that you are able to complete the follow-up tasks in Follow-up tasks.
-
Ask users to validate the results of the migrations.
-
Resolve any issues uncovered by your trial migrations.
-
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
./FILENAME -
Se estiver usando o PowerShell, use
.\.Shell .\FILENAME
.\FILENAME