4. Monitorizar a migração

Serviços de DevOps do Azure

A sincronização inicial pode demorar várias horas ou até dias a ser concluída, dependendo do tamanho do seu repositório. Após o término da sincronização inicial, o ELM continua a realizar sincronizações periódicas durante até 21 dias para captar atualizações em andamento. Durante este período de 21 dias, tem de efetuar 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. Surgem erros na saída do estado da migração para que possa identificar e corrigir problemas antes de continuar.

Importante

Limite de concorrência: Cada empresa pode ter até 30 migrações ativas em curso ao mesmo tempo, incluindo um máximo de 20 migrações iniciais. Para libertar capacidade para outra migração, completar o corte para uma migração existente.

Acompanhar o estado da migração

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

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

Estágios de migração

Stage Description
Em fila Migração aprovada; o trabalho ainda não começou.
Validação A executar verificações de pré-migração.
Synchronization Copiar e sincronizar conteúdos do repositório.
Transição A executar a sincronização final e a transição para o GitHub.
ReviewForCutover Cutover chegou à hora agendada com falhas por resolver e está a aguardar cutover approve (ou reagendamento).
Pronto para a mudança Aprovado e à espera do próximo trabalho ELM para fazer o corte final.
Migrado Migração concluída. GitHub é o sistema de registo.

Status de migração

Status Meaning
Active A migração está a decorrer.
Succeeded Fase atual concluída com sucesso.
Concluído A migração atingiu a fase terminal Migrated .
Falhado Ocorreu um erro. Podes retomar depois de corrigires o problema.
Suspenso Pausado manualmente. Podes retomar.

O que observar

  • Último tempo de sincronização bem-sucedido — confirme que as sincronizações estão a correr conforme o planeado.
  • Estado de sincronização — identificar se a migração está a progredir ou estagnada.
  • Condições de erro — O ELM repete automaticamente as tentativas após falhas transitórias. Erros persistentes requerem investigação.

Retomar após um erro de sincronização

Se ocorrerem erros de sincronização, investigue os detalhes do erro e resolva o problema subjacente. Depois, deixe o ELM retomar automaticamente, ou use um dos seguintes métodos.

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

Pausar e retomar a migração

Se precisares de parar 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>

Observação

Pode pausar uma migração por qualquer período de tempo, mas a janela de transição de 21 dias ainda se aplica.

Cancelar a migração

A qualquer momento durante a sincronização, pode parar e apagar uma migração. Esta ação apaga permanentemente o registo de migração.

Execute o seguinte comando. És convidado a confirmar.

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

Após o cutover, o repositório Azure DevOps é definido para apenas leitura. Se quiseres voltar a escrever nele, adiciona --remove-read-only para restaurar o acesso de gravação. Este indicador só se aplica depois da transição.

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

Para saltar o prompt interativo de confirmação (para limpeza scriptada), adicione --yes.

Depois de abandonar uma migração:

  • Repositório de origem: O seu repositório do Azure DevOps mantém-se inalterado e totalmente gravável. Nenhuma limpeza é necessária.
  • Registo de auditoria: O registo de migração não é mantido, mas é escrito um evento de auditoria para indicar que a migração foi abandonada. Para mais informações, consulte Auditoria.
  • Iniciar uma nova migração: Pode criar uma nova migração para o mesmo repositório de origem, mas aplica-se um curto tempo de recarga antes de a nova migração começar. Se quiseres reutilizar o mesmo nome do repositório GitHub de destino, primeiro apaga o repositório GitHub existente. Deve ter permissão Delete repository em GitHub para fazer isto.

Passo seguinte