Pré-requisitos
- Você deve ter concluído todas as fases anteriores deste guia.
- Certifique-se de entender os dados que serão migrados e as limitações de suporte conhecidas do Importador. Para obter mais informações, consulte Fase 1. Entender as migrações do Azure DevOps para o GitHub.
- Migrações delta não são suportadas.
Gerar um script de migração
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.
Para gerar um script de migração, execute o comando gh ado2gh generate-script.
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. |
Argumentos adicionais
| Argument | DESCRIÇÃO |
|---|---|
--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://api.octocorp.ghe.com. |
--all | Adicione funcionalidades adicionais ao script, como rewiring de pipelines, criação de equipes e configuração de integrações de Azure Boards. |
--download-migration-logs | Baixe o log de migração de cada repositório migrado. Para obter mais informações sobre os logs de migração, confira Como acessar os logs de migração do GitHub Enterprise Importer. |
Como revisar o script de migração
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.
Executar um teste piloto
Execute suas migrações
-
Crie uma organização de teste para as migrações de avaliação.
Use uma única organização para todas as execuções de teste ou crie uma organização de teste para cada organização de destino pretendida. Considere a inclusão de
-sandboxno final dos nomes da organização, para esclarecer que as organizações se destinam apenas à validação de migração e não à produção. Você pode excluir as organizações de teste depois de terminar. -
Execute as migrações de teste.
-
Confirme se você é capaz de concluir as tarefas de acompanhamento em Fase 6. Tarefas de acompanhamento.
-
Solicite aos usuários que validem os resultados das migrações.
-
Resolva os problemas descobertos pelas migrações de teste.
-
Opcionalmente, exclua a organização de teste.
Migrar repositórios
Se sua execução de teste foi bem-sucedida e você conseguiu concluir as tarefas de acompanhamento, poderá prosseguir para a migração real.
Aviso
Recomendamos interromper o trabalho nos repositórios que você está migrando. Todas as alterações feitas durante ou após a migração precisarão ser migradas manualmente.
Próximas etapas
Na próxima e última fase, você executará tarefas de acompanhamento, verificará os logs e preparará seus repositórios para uso. Confira Fase 6. Tarefas de acompanhamento.