4. Monitorar a migração

Serviços do Azure DevOps

A sincronização inicial pode levar várias horas ou até dias para ser concluída, dependendo do tamanho do repositório. Após a conclusão da sincronização inicial, o ELM continua a executar sincronizações periódicas por até 21 dias para capturar atualizações em andamento. Durante essa janela de 21 dias, você deve realizar a transição final para concluir a migração.

Para ver quais repositórios estão em cada fase, execute az devops migrations list e filtre pelo stage campo. Os erros aparecem na saída do status de migração para que você possa identificar e corrigir problemas antes de continuar.

Importante

Limite de simultaneidade: cada empresa pode ter até 30 migrações ativas em andamento ao mesmo tempo, incluindo um máximo de 20 migrações iniciais. Para liberar a capacidade de outra migração, conclua a substituição de uma migração existente.

Acompanhar o status da migração

Liste todas as migrações para sua organização:

az devops migrations list --org https://dev.azure.com/<org>

Estágios de migração

Stage Description
Em fila Migração aceita; O trabalho ainda não começou.
Validação Executando verificações de pré-migração.
Synchronization Copiando e sincronizando o conteúdo do repositório.
Transição Executando a sincronização final e a transição para GitHub.
ReviewForCutover O cutover chegou ao horário agendado com falhas não resolvidas e aguarda cutover approve (ou reagendamento).
ReadyForCutover Aprovado e aguardando o próximo trabalho do ELM executar a substituição final.
Migrado Migração concluída. GitHub é o sistema de registro.

Status da migração

Status Meaning
Ativo A migração está em execução.
Succeeded A fase atual foi concluída com êxito.
Concluído A migração atingiu o estágio terminal Migrated.
Falha Ocorreu um erro. Você pode retomar depois de corrigir o problema.
Suspenso Pausado manualmente. Você pode continuar.

O que observar

  • Hora da última sincronização bem-sucedida – confirme se as sincronizações estão em execução no agendamento.
  • Estado de sincronização – identifique se a migração está progredindo ou parada.
  • Condições de erro — o ELM tenta novamente falhas transitórias automaticamente. Erros persistentes exigem investigação.

Retomar após um erro de sincronização

Se ocorrerem erros de sincronização, investigue os detalhes do erro e corrija o problema subjacente. Em seguida, permita que o ELM seja retomado automaticamente ou use um dos métodos a seguir.

az devops migrations resume --org https://dev.azure.com/<org>
                            --repository-id <repo-guid>

Pausar e retomar a migração

Se você precisar interromper temporariamente uma migração e reiniciá-la no mesmo modo:

Para pausar a migração, execute:

az devops migrations pause --org https://dev.azure.com/<org>
                           --repository-id <repo-guid>

Para retomar a migração, execute:

az devops migrations resume --org https://dev.azure.com/<org>
                            --repository-id <repo-guid>

Note

Você pode pausar uma migração por quanto tempo quiser, mas a janela de transição de 21 dias ainda se aplica.

Cancelar a migração

A qualquer momento durante a sincronização, você pode parar e excluir uma migração. Essa ação exclui permanentemente o registro de migração.

Execute o comando a seguir. Você será solicitado a confirmar.

az devops migrations abandon --org https://dev.azure.com/<org>
                             --repository-id <repo-guid>

Após a migração, o repositório do Azure DevOps é configurado como somente leitura. Se você quiser voltar a escrever nele, adicione --remove-read-only para restaurar o acesso de escrita. Esse sinalizador só se aplica após a transição.

az devops migrations abandon --org https://dev.azure.com/<org>
                             --repository-id <repo-guid>
                             --remove-read-only

Para ignorar a solicitação interativa de confirmação (para limpeza automatizada por script), adicione --yes.

Depois de abandonar uma migração:

  • Repositório de origem: Seu repositório do Azure DevOps permanece inalterado e totalmente editável. Nenhuma limpeza é necessária.
  • Trilha de auditoria: o registro de migração não é mantido, mas um evento de auditoria é gravado para registrar que a migração foi abandonada. Para obter mais informações, consulte Auditoria.
  • Iniciando uma nova migração: você pode criar uma nova migração para o mesmo repositório de origem, mas um breve resfriamento se aplica antes que a nova migração possa ser iniciada. Se você quiser reutilizar o mesmo nome de GitHub repositório de destino, exclua primeiro o repositório GitHub existente. Você deve ter permissão Excluir repositório no GitHub para fazer isso.

Próxima etapa