Observação
Enterprise Live Migrations está dentro versão prévia pública e sujeito a alterações.
Se a migração encontrar um problema, verifique o status da migração com elm migration status --migration-id MIGRATION-ID e revise as informações de erro.
Status e ações recomendadas
| Status | Meaning | Ação recomendada |
|---|---|---|
| Criado | A migração foi criada, mas ainda não foi iniciada | Execute elm migration start |
| Queued | A migração está aguardando o início | Wait |
| Exportadores | Os dados estão sendo exportados da origem | Monitorar com elm migration status |
| Em processamento | Os dados exportados estão sendo importados para o destino | Monitorar com elm migration status |
| Pronto para substituição | A migração inicial está concluída e a migração está pronta para mudança. | Quando estiver pronto, execute elm migration cutover-to-destination |
| Transição | O repositório de origem está bloqueado e as alterações restantes estão sendo aplicadas ao destino | Monitor; o status fará a transição para Concluído |
| Completed | A migração foi concluída com êxito | Verifique o repositório de destino e recupere os modelos |
| Falhou | A migração encontrou uma falha irrecuperável | Investigar o erro (veja abaixo) |
| Pausado | A migração está pausada | Retomar a migração |
| Terminada | A migração foi cancelada | N/A |
| Degradado | O destino é inacessível | Verificar a conectividade de rede entre o dispositivo GitHub Enterprise Server e GHE.com (veja abaixo) |
O status da migração é "Falha"
Uma migração entra no status com falha quando um erro irrecuperável o impede de continuar. Isso é diferente dos recursos individuais que não foram importados. Uma migração com falha significa que a migração em si não pode continuar.
Para investigar, execute elm migration status --migration-id MIGRATION-ID e examine os detalhes do erro na resposta. Cada falha inclui uma ID de correlação no formato (Correlation ID for Support: UUID). Se você entrar em contato Suporte do GitHub, forneça esta ID para que a equipe de suporte possa investigar.
Depois de resolver o problema subjacente, anule a migração falha com elm migration cancel --migration-id MIGRATION-ID e inicie uma nova migração.
O status da migração é "Degradado"
Um status degradado significa que o serviço de migração no GitHub Enterprise Server dispositivo não pode alcançar a empresa de destino. A migração continua no lado da origem, mas o status de destino é desconhecido.
Verifique a conectividade de rede entre o GitHub Enterprise Server equipamento e o seu subdomínio de GHE.com, em seguida, execute elm migration status --migration-id MIGRATION-ID novamente. A resposta de status inclui um carimbo de data/hora do último contato bem-sucedido com o destino, ajudando a determinar há quanto tempo o problema de conectividade está ocorrendo.
Alguns recursos não foram importados
Os recursos individuais podem falhar ao importar sem causar falha na migração geral. Você pode ver uma contagem de recursos falhados na saída de elm migration status --migration-id MIGRATION-ID.
Os recursos com falha são mostrados somente depois que todas as novas tentativas automáticas tiverem sido esgotadas, portanto, todas as falhas que você vê são confirmadas como insolvíveis sem intervenção. Revise os detalhes do erro na resposta de status: cada recurso que falhar em processos de preenchimento retroativo ou atualizações ao vivo será exibido com "state": "failed".
Se o número e os tipos de recursos com falha forem aceitáveis, você poderá continuar com a substituição. Caso contrário, anule a migração, resolva o problema subjacente e inicie uma nova migração.
Falha na substituição e o repositório de origem está bloqueado
Se uma migração falhar parcialmente, o repositório de origem poderá permanecer bloqueado ou arquivado. Isso impede que os desenvolvedores façam push para o repositório de origem quando o destino ainda pode estar incompleto.
Para desbloquear o repositório de origem, um administrador de site deve desbloqueá-lo do GitHub Enterprise ServerConsole de Gerenciamento.
Depois que a origem for desbloqueada, você poderá tentar novamente a substituição usando elm migration cutover-to-destination --migration-id MIGRATION-ID, ou anular a migração com elm migration cancel --migration-id MIGRATION-ID e iniciar uma nova migração quando estiver pronto.
A migração deve ser reiniciada devido a um push de força
Se alguém executar um push forçado para o ramo padrão do repositório de origem durante uma migração em andamento, a sincronização do Git entre o repositório de origem e o de destino é interrompida. Forçar pushes reescreve o histórico de confirmação de uma maneira que não pode ser reconciliada incrementalmente.
Se isso acontecer, aborte a migração elm migration cancel --migration-id MIGRATION-ID e inicie uma nova migração. Antes de reiniciar, comunique à sua equipe que pushes forçados para o branch padrão não são permitidos enquanto uma migração está ativa.
O token de acesso foi rejeitado
Se a migração falhar com um erro de autenticação, verifique se:
- Os tokens de origem e de destino são personal access tokens (classic). Não há suporte para tokens refinados.
- Os tokens têm os escopos especificados em Migrando seu repositório com Enterprise Live Migrations.
- Se a organização de destino impor o logon único do SAML, o token deverá ser autorizado para SSO.
A URL de origem do GHES foi rejeitada
Enterprise Live Migrations requer a GitHub Enterprise Server URL para usar HTTPS. Se a URL estiver configurada com HTTP, a migração falhará na validação de pré-vôo.