Skip to main content

Sobre migrações do Azure DevOps para o GitHub Enterprise Cloud

Saiba quais dados podem ser migrados pelo GitHub Enterprise Importer.

Sobre as migrações do Azure DevOps

Use o GitHub Enterprise Importer para migrar repositórios do Azure DevOps para o GitHub Enterprise Cloud (GitHub.com ou GHE.com).

Você só pode usar o GitHub Enterprise Importer para migrar do Azure DevOps Cloud, não do Azure DevOps Server. Atualmente, se você usa o Azure DevOps Server e deseja migrar para o GitHub, migre primeiro para o Azure DevOps Cloud. Para obter mais informações, confira Migrar para o Azure DevOps no site do Azure.

Dados que são migrados

Atualmente, só damos suporte à migração dos dados de repositório a seguir do Azure DevOps para o GitHub Enterprise Cloud.

  • Origem do Git (incluindo o histórico de commits)
  • Solicitações de pull
  • Histórico de usuários para solicitações de pull
  • Links de item de trabalho em solicitações de pull
  • Anexos em solicitações de pull
  • Políticas de ramificação para o repositório (políticas de ramificação com escopo de usuário e políticas de ramificação entre repositórios não estão incluídas)

Caso você deseje migrar o Azure Pipelines para o GitHub Actions, entre em contato com o gerente de contas do GitHub.

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 tamanho de 40 GB para um repositório Git (versão prévia pública): este limite de aplica apenas ao código-fonte. Para verificar se o arquivo do repositório está acima do limite, use a ferramenta git-sizer e analise o tamanho total do BLOB na saída. A ferramenta git-sizer também ajuda a identificar possíveis problemas relacionados a arquivos grandes, tamanho de BLOB, tamanho de commit e contagens de árvores que podem afetar as migrações.
  • 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 Azure DevOps, você deve planejar como executará sua 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 Azure DevOps para o GitHub Enterprise Cloud.