Observação
Enterprise Live Migrations está dentro versão prévia pública e sujeito a alterações.
O que é o Enterprise Live Migrations?
Enterprise Live Migrations (ELM) é um serviço para migrar repositórios de GitHub Enterprise Server para GitHub Enterprise Cloud com residência de dados (GHE.com). Ele é operado usando uma ferramenta de linha de comando em GitHub Enterprise Server.
As migrações são "dinâmicas" porque os usuários podem continuar usando o repositório de origem durante a maior parte do processo de migração. Depois que os dados do repositório são coletados inicialmente, os webhooks verificam se há alterações no repositório, como novas confirmações ou atualizações nas configurações. Essas alterações são reportadas ELM e incluídas na migração.
Uma ELM migração inclui um único repositório. Os dados no nível da organização, como configurações da organização, equipes e projetos, não são incluídos na migração e devem ser reconfigurados manualmente na empresa de destino.
Diferenças de GitHub Enterprise Importer
ELM e GitHub Enterprise Importer (GEI) são ferramentas separadas que dão suporte à migração de repositórios de GitHub Enterprise Server para GHE.com.
Os principais benefícios de ELM são:
- Tempo de inatividade reduzido do desenvolvedor: durante uma migração com GEI, os desenvolvedores perdem o acesso ao repositório durante a migração. Esse tempo de inatividade cria riscos como implantações bloqueadas ou desenvolvimento de funcionalidades estagnado.
- Suporte ao Monorepo: ELM é capaz de migrar monorepos grandes e complexos com histórias profundas. Geralmente, elas excedem a capacidade do GEI.
- Melhor visibilidade: ELM fornece visibilidade detalhada no nível do repositório sobre o progresso da migração, apresentando falhas granulares para que você possa ter certeza de que o repositório migrado é uma réplica precisa.
No entanto, devido à carga de tráfego mais alta associada a atualizações dinâmicas, ELM dá suporte a menos migrações simultâneas do que o GEI: até 10 migrações simultâneas de repositório de uma única GitHub Enterprise Server instância e 20 migrações simultâneas por empresa de destino.
Talvez você queira usar ambas as ferramentas ao longo de uma migração de plataforma, priorizando os repositórios que mais se beneficiarão ELM.
Visão geral de uma migração
Normalmente, um administrador de site executa uma migração usando a elm ferramenta CLI, em uma sessão de terminal por SSH. O operador deve fornecer ao personal access tokens acesso tanto ao GitHub Enterprise Server quanto à empresa de destino.
As fases de alto nível de uma migração são:
-
**Criação**: o administrador do site executa comandos da CLI para criar e iniciar a migração, especificando o repositório de origem e o destino. -
**Verificações de pré-vôo**: o serviço de migração verifica parâmetros, tokens, conectividade de rede e configuração do repositório. -
**Backfill**: a ELM ferramenta faz um rastreamento inicial para capturar todos os dados do repositório e os envia para o serviço de migração na plataforma de destino. Durante a fase de backfill, os webhooks verificam se há atualizações em tempo real no repositório enquanto a migração prossegue. -
**Transição**: o repositório de origem está bloqueado e todas as atualizações finais em tempo real são enviadas para ELM. Esse é o período de tempo de inatividade para desenvolvedores. -
**Conclusão**: a migração foi concluída. O administrador do site pode verificar se os dados foram migrados com êxito. -
**Acompanhamento**: um proprietário da organização executa tarefas de acompanhamento na empresa de destino, como reconfigurar as configurações da organização e atribuir atividade novamente aos usuários.
Próximas Etapas
Para se preparar para executar uma migração, consulte Preparando sua migração ao vivo do GitHub Enterprise Server para o GHE.com.