Sobre as migrações do Bitbucket Server
Você pode usar o GitHub Enterprise Importer para migrar repositórios do Bitbucket Server para o GitHub Enterprise Cloud (GitHub.com ou GHE.com). As migrações do Bitbucket Server são suportadas apenas para o Bitbucket Server ou Bitbucket Data Center versão 5.14 ou superior.
Dados que são migrados
Atualmente, só damos suporte à migração dos dados do repositório a seguir do Bitbucket Server para o GitHub Enterprise Cloud.
-
Origem do Git (incluindo o histórico de commits)
-
Solicitações de pull (incluindo comentários, revisões de solicitação de pull, comentários de revisão de solicitação de pull no nível de arquivo e linha, revisores necessários e anexos)
Observação
Os usuários podem receber um erro
500ao tentar exibir uma pull request se a pull request tiver sido mesclada e o branch head tiver sido excluído no Bitbucket Server antes da migração. O Bitbucket Server remove referências específicas do Git a objetos para essas pull requests e, consequentemente, os objetos Git associados à pull request não podem ser migrados.
Dados que não são migrados
Atualmente, os dados a seguir não são migrados.
- Repositórios pessoais pertencentes aos usuários
- Permissões de branch
- Comentários de commit
- Configurações do repositório
- Pipelines de CI
Limitações dos dados migrados
Há limites para o que o GitHub Enterprise Importer pode migrar. Alguns ocorrem devido a limitações do GitHub, enquanto outros são limitações do próprio GitHub Enterprise Importer.
Limitações do GitHub
- Limite de tamanho de 2 GiB para uma única confirmação do Git: Nenhuma confirmação única em seu repositório Git pode ser maior que 2 GiB. Se algum de seus commits for maior que 2 GiB, você precisará dividi-lo em commits menores, cada um com 2 GiB ou menos.
- Limite de 255 bytes para referências do Git: nenhuma referência individual do Git, comumente conhecida como "referência", pode ter um nome maior que 255 bytes. Normalmente, isso significa que as referências não podem ter mais de 255 caracteres, mas qualquer caractere não ASCII, como emojis, pode consumir mais de um byte. Se uma das referências do Git for muito grande, retornaremos uma mensagem de erro clara.
- Limite de tamanho de arquivo de 100 MiB: Depois de concluir a migração, nenhum arquivo único no repositório Git poderá ter mais de 100 MiB. Durante a migração do repositório, esse limite é aumentado para 400 MiB. Considere o uso do Git LFS para armazenar arquivos grandes. Para saber mais, confira Gerenciar arquivos grandes.
Limitações do GitHub Enterprise Importer
- Limite de tamanho de 40 GiB para arquivos de arquivamento do repositório (versão prévia pública): O Importer não pode migrar repositórios com mais de 40 GiB de dados de git combinados e metadados no arquivo de repositório. limitações das ferramentas de migração
Começando
Antes de migrar do Bitbucket Server, você deve planejar como executará a migração. Antes de migrar quaisquer dados, você precisará escolher alguém para executar a migração. Você deve conceder a essa pessoa o acesso necessário à origem e ao destino da migração. Também recomendamos executar uma migração de teste primeiro.
Para obter uma visão geral do processo de migração do início ao fim, confira Visão geral de uma migração do Bitbucket Server para o GitHub Enterprise Cloud.