Sobre as migrações do Bitbucket Server para o GitHub Enterprise Cloud

Saiba quais dados podem ser migrados pelo GitHub Enterprise Importer.

Neste artigo

Sobre as migrações do Bitbucket Server

Use o GitHub Enterprise Importer para migrar repositórios do Bitbucket Server para o GitHub Enterprise Cloud (GitHub.com ou GHE.com). Só há suporte para as migrações do Bitbucket Server no Bitbucket Server ou no 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 500 ao 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 GB para um commit individual do Git: nenhum commit individual no repositório Git pode ter mais de 2 GB. Se um dos commits for maior que 2 GB, divida o commit em commits menores que tenham 2 GB ou menos cada.
  • 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 100 MB para arquivos: após a conclusão da migração, nenhum arquivo individual no repositório Git pode ter mais de 100 MB. Durante a migração do repositório, esse limite é aumentado para 400 MB. 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 40 GB para arquivos de repositório (versão prévia pública): o Importer não pode migrar repositórios com mais de 40 GB de dados e metadados combinados no arquivo de repositório.
  • 400 MB file size limit: When migrating a repository with GitHub Enterprise Importer, no single file in your Git repository can be larger than 400 MB. Consider using Git LFS for storing large files. For more information, see Gerenciar arquivos grandes.
  • Git LFS objects not migrated: The Importer can migrate repositories that use Git LFS, but the LFS objects themselves will not be migrated. They can be pushed to your migration destination as a follow-up task after the migration is complete. For more information, see Duplicar um repositório.
  • Follow-up tasks required: When migrating between GitHub products, certain settings are not migrated and must be reconfigured in the new repository. For a list of follow-up tasks you'll need to complete after each migration, see Visão geral de uma migração entre produtos GitHub.
  • Delayed code search functionality: Re-indexing the search index can take a few hours after a repository is migrated, and code searches may return unexpected results until re-indexing is complete.
  • Rulesets configured for your organization can cause migrations to fail: For example, if you configured a rule that requires email addresses for commit authors to end with @monalisa.cat, and the repository you're migrating contains commits that don't comply with this rule, your migration will fail. For more information about rulesets, see Sobre os conjuntos de regras.
  • Mannequin content might not be searchable: Mannequins are placeholder users to which imported content (such as issues, pull requests, comments, etc.) is associated. When you search for content associated with a mannequin, such as assigned issues, the issues may not be found. Once a mannequin is reclaimed, the content should be found via the new owner. For more information, see Como recuperar manequins no GitHub Enterprise Importer.

Introdução

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 avaliação 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.