Observação
Enterprise Live Migrations está dentro prévia pública e sujeito a alterações.
Nossa instância GitHub Enterprise Server está pronta?
ELM está disponível nas versões de patch mais recentes para GitHub Enterprise Server 3.17 e posteriores. Esta documentação pressupõe que você esteja usando a seguinte versão do patch ou posterior. As instruções podem não funcionar em versões anteriores.
3.21.23.20.43.19.83.18.113.17.17
Sua GitHub Enterprise Server instância também deve:
- Use uma URL HTTPS . Não há suporte para URLs HTTP.
- Permitir o tráfego de saída para o destino da migração.
- Tenha migrações habilitadas na seção "Migrações" do Console de Gerenciamento.
- Prepare-se para uma carga adicional durante a migração: o arquivamento do repositório faz com que todos os problemas e solicitações de pull no repositório sejam retirados do MySQL e reindexados no Elasticsearch.
Como será nossa organização de destino?
Você pode migrar repositórios para uma organização nova ou existente.GHE.com O ELM criará a organização de destino se ela ainda não existir.
Uma migração de plataforma é uma boa oportunidade para reconsiderar sua organização e estrutura de equipe. Consulte Práticas recomendadas para organizar o trabalho em sua empresa.
Quais repositórios migraremos?
ELM suporta 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.
Planeje com quais repositórios você migrará ELM primeiro e quais você poderá migrar depois ou usando uma ferramenta de migração diferente. Os repositórios mais propensos a se beneficiarem de ELM são:
- Repositórios importantes onde longos períodos de inatividade poderiam interromper seus negócios
- Monorepos grandes demais para outras ferramentas de migração
Repositórios públicos não estão disponíveis em GHE.com, e repositórios públicos serão rejeitados por ELM. Você pode alterar a visibilidade desses repositórios na GitHub Enterprise Server antes de começar.
Você deve verificar se os repositórios escolhidos não contêm ativos de versão com mais de 2 GB, pois esse é o limite para ELM.
Quem executará a migração?
A pessoa que executa uma migração ELM deve:
- Ter acesso de administrador ao site na instância GitHub Enterprise Server
- Ser proprietário corporativo na empresa GHE.com
Essa pessoa precisará executar as seguintes tarefas:
- Antes da migração, crie personal access tokens (classic) na empresa de origem e de destino.
- Durante a migração, monitore o status da migração e responda a problemas.
Para migrações simultâneas ELM de uma GitHub Enterprise Server instância, a mesma pessoa deve executar todos os elm comandos usando os mesmos tokens.
Após a migração, alguém precisará executar algumas tarefas de acompanhamento em GHE.com. Qualquer proprietário da organização pode fazer isso.
O que meus desenvolvedores devem saber?
Antes de começar, comunique-se com os desenvolvedores que:
- O repositório está sendo movido para um novo local. Os usuários podem continuar a usar o repositório de origem durante a migração até que o operador inicie a substituição final para o novo local. Após a migração, o repositório de origem será arquivado e, portanto, ficará somente para leitura, a menos que seja desarquivado por um administrador do repositório.
- Embora a migração esteja em andamento, os desenvolvedores devem evitar realizar force pushes para o repositório, pois isso interromperá o histórico do Git de uma forma que ELM não consiga resolver.
- Determinadas ações executadas pelos desenvolvedores durante o processo de migração podem não ser refletidas no repositório migrado. Para obter detalhes, consulte as ações sem suporte em Dados migrados para migrações dinâmicas do GitHub Enterprise Server para o GHE.com.
Próximas Etapas
Quando estiver pronto para executar uma migração, consulte Migrando seu repositório com Enterprise Live Migrations.