Tipos de migrações
Você pode fazer três tipos de migração:
- Uma migração de uma GitHub Enterprise Server instância para outra instância existente 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.
- Uma migração de uma GitHub.com organização para uma GitHub Enterprise Server instância. você pode migrar qualquer número de repositórios pertencentes à organização. Antes de executar uma migração, você deve ter acesso administrativo à GitHub.com organização, bem como acesso de administrador de site à 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 GitHub.com. 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.
Observação
O uso de ghe-migrator não é recomendado para transferir uma GitHub Enterprise Server instância 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 usando Utilitários de Backup, 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 Git LFS ativos.
Observação
As relações de fork não persistem após uma migração.
| Dados associados a um repositório migrado | Observações |
|---|---|
| Usuários | |
| ** | |
| @mentions | |
| ** dos usuários são rescritas para corresponderem ao destino. | |
| Organizações | Os nomes e detalhes de uma organização são migrados. |
| Repositórios | Links 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 não está definido. |
| Wikis | Todos os dados da wiki são migrados. |
| Teams | |
| ** | |
| @mentions | |
| ** das equipes são rescritas para corresponderem ao destino. | |
| Marcos | Os registros de data e hora são preservados. |
| Problemas | As referências a questões e os carimbos de data e hora são preservados. |
| Comentários dos problemas | As referências cruzadas aos comentários são rescritas para a instância de destino. |
| Solicitações de pull | As 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 request | As revisões de pull request e os dados associados são migrados. |
| Comentários das revisões de pull request | As 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 commit | As 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ões | Todos os dados de lançamento são migrados. |
| Ações feitas em problemas ou em pull requests | Todas as modificações em pull requests ou problemas, como atribuição de usuários, renomeação de títulos e modificação de rótulos, são preservadas, juntamente com os timestamps de cada ação. |
| Anexos de arquivo | Os anexos de arquivo em problemas e solicitações de pull são migrados. Você pode desabilitar essa opção como parte da migração. |
| Webhooks | Somente os webhooks ativos são migrados. |
| Chaves de implantação de repositório | As chaves de implantação de repositório são migradas. |
| Ramificações protegidas | As configurações de ramificações protegidas e os dados associados são migrados. |
Sobre migração de dados de autenticação externa
Se o local de origem da migração for um GitHub produto que usa autenticação LDAP ou SAML, ghe-migrator não migrará 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 a autenticação para sua empresa" na documentação GitHub Enterprise Server ou na documentação 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 a partir de Console de Gerenciamento. Para saber mais, confira Acessando o Console de Gerenciamento.