Skip to main content

Sobre o ghe-migrator

Você pode usar o ghe-migrator para transferir dados de um local de origem (uma organização do GitHub.com ou uma instância do GitHub Enterprise Server) para uma instância do GitHub Enterprise Server de destino.

Tipos de migrações

Você pode fazer três tipos de migração:

  • Migração de uma instância do GitHub Enterprise Server para outra existente do GitHub Enterprise Server. você pode migrar qualquer número de repositórios pertencentes a qualquer usuário ou organização na instância. Para executar a migração, você deve ter acesso de administrador do site a ambas as instâncias.
  • Migração de uma organização do GitHub.com para uma instância do GitHub Enterprise Server: você pode migrar qualquer número de repositórios pertencentes à organização. Antes de executar uma migração, você precisa ter acesso administrativo na organização do GitHub.com e acesso de administrador do site na instância de destino.
  • As execuções de avaliação são migrações que importam dados para uma instância de preparo. Elas podem ser úteis para ver o que aconteceria se uma migração fosse aplicada ao sua instância do GitHub Enterprise Server. Recomendamos fortemente que você execute uma execução de avaliação em uma instância de preparo antes de importar dados para sua instância de produção.

Note

O uso do ghe-migrator não é recomendado para transferir uma instância do GitHub Enterprise Server entre hipervisores. Em vez disso, sugerimos fazer backup e restaurar para o novo local com GitHub Enterprise Server Backup Utilities ou criar uma réplica no novo local e, em seguida, fazer failover para o dispositivo de réplica. Para saber mais, confira "Como configurar backups em sua instância", "Criar réplica de alta disponibilidade" e "Iniciar failover do appliance réplica".

Dados migrados

Com o ghe-migrator, tudo gira em torno de um repositório. A maioria dos dados associados ao repositório pode ser migrada. Por exemplo, um repositório em uma organização migrará o repositório e a organização, bem como todos os usuários, as equipes, os problemas e as solicitações de pull associadas ao repositório.

Os itens na tabela abaixo podem ser migrados com um repositório. Os itens não mostrados na lista de dados migrados não podem ser migrados, incluindo os ativos do Git LFS.

Note

As relações de fork não persistem após uma migração.

Dados associados a um repositório migradoObservações
UsuáriosAs @mentions aos usuários são rescritas para corresponderem ao destino.
OrganizaçõesOs nomes e detalhes das organizações são migrados.
RepositóriosLinks para árvores, blobs, commits e linhas do Git são rescritas para corresponder ao destino. Repositórios internos são migrados como repositórios privados. O status de arquivo morto não está definido.
WikisTodos os dados da wiki são migrados.
TeamsAs @mentions às equipes são rescritas para corresponderem ao destino.
MarcosOs registros de data e hora são preservados.
Quadros de Projects (classic)Os Projetos (clássicos) associados ao repositório e à organização proprietária do repositório são migrados. Projects, a experiência de projetos completamente nova, agora está disponível.
ProblemasAs referências a problemas e os registros de data e hora são preservados.
Comentários dos problemasAs referências cruzadas aos comentários são rescritas para a instância de destino.
Solicitações de pullAs referências cruzadas a pull requests são rescritas para corresponder ao destino. Os registros de data e hora são preservados.
Revisões de pull requestAs revisões de pull request e os dados associados são migrados.
Comentários das revisões de pull requestAs referências cruzadas aos comentários são rescritas para a instância de destino. Os registros de data e hora são preservados. Os comentários no nível do arquivo não são migrados.
Comentários de commitAs referências cruzadas aos comentários são rescritas para a instância de destino. Os registros de data e hora são preservados.
VersõesTodos os dados das versões são migrados.
Ações feitas em problemas ou em pull requestsSão preservadas todas as modificações em problemas ou pull requests, como atribuir usuários, renomear títulos e modificar etiquetas, bem como os registros de data e hora de cada ação.
Anexos de arquivoOs anexos de arquivo em problemas e solicitações de pull são migrados. Você pode desabilitar essa opção como parte da migração.
WebhooksSomente os webhooks ativos são migrados.
Chaves de implantação de repositórioAs chaves de implantação de repositório são migradas.
Branches protegidosAs configurações de branches protegidos e os dados associados são migrados.

Sobre migração de dados de autenticação externa

Se a origem da migração for um produto do GitHub que usa autenticação LDAP ou SAML, o ghe-migrator não migrará os dados de autenticação externa vinculados a contas de usuário. Para obter mais informações sobre as opções de autenticação, consulte GitHub Enterprise Server, consulte "Sobre autenticação para a sua empresa" nos documentos do GitHub Enterprise Server" ou nos documentos do GitHub Enterprise Cloud.

Se você migrar para uma instância de destino e depois configurar a autenticação externa, os usuários deverão entrar na instância de destino com uma conta de usuário que tenha o mesmo nome de usuário ou ID de usuário que a conta na instância de origem. Os administradores podem revisar o atributo externo que uma instância usa para mapear nomes de contas de usuário no GitHub. Para obter mais informações, confira "Acessar o Console de Gerenciamento".