Información sobre migraciones de Bitbucket Server a GitHub Enterprise Cloud

Descubra qué datos GitHub Enterprise Importer puede migrar.

En este artículo

Acerca de las migraciones desde Bitbucket Server

Puedes usar GitHub Enterprise Importer para migrar repositorios de Bitbucket Server a GitHub Enterprise Cloud (GitHub.com o GHE.com). Las migraciones de Bitbucket Server solo se admiten para Bitbucket Server o Bitbucket Data Center versión 5.14 o posterior.

Datos que se migran

Actualmente solo se admite la migración de los siguientes datos de repositorio de Bitbucket Server a GitHub Enterprise Cloud.

  • Origen de Git (incluido el historial de confirmaciones)

  • Solicitudes de incorporación de cambios (como comentarios, revisiones de solicitudes de incorporación de cambios, comentarios de revisión de solicitudes de incorporación de cambios en el nivel de archivo y línea, revisores necesarios y datos adjuntos)

    Nota:

    Los usuarios pueden recibir un error 500 si intentan ver una solicitud de incorporación de cambios y si la solicitud de incorporación de cambios se ha combinado y la rama principal se ha eliminado en Bitbucket Server antes de la migración. Bitbucket Server quita referencias de Git específicas a objetos de estas solicitudes de incorporación de cambios y, por lo tanto, los objetos de Git asociados a la solicitud de incorporación de cambios no se pueden migrar.

Datos que no se migran

Actualmente, no se migran los datos siguientes.

  • Repositorios personales propiedad de los usuarios
  • Permisos de rama
  • Comentarios sobre confirmación de cambios
  • Configuración del repositorio
  • Canalizaciones de CI

Limitaciones de los datos migrados

There are limits to what GitHub Enterprise Importer can migrate. Some are due to limitations of GitHub, while others are limitations of GitHub Enterprise Importer itself.

Limitations of GitHub

  • 2 GB size limit for a single Git commit: No single commit in your Git repository can be larger than 2 GB. If any of your commits are larger than 2 GB, you will need to split the commit into smaller commits that are each 2 GB or smaller.
  • 255 byte limit for Git references: No single Git reference, commonly known as a "ref", can have a name larger than 255 bytes. Usually, this means that your references cannot be more than 255 characters long, but any non-ASCII characters, such as emojis, may consume more than one byte. If any of your Git references are too large, we'll return a clear error message.
  • 100 MB file size limit: After you complete your migration, no single file in your Git repository can be larger than 100 MB. During repository migration this limit is increased to 400 MB. Consider using Git LFS to store large files. For more information, see Administrar archivos grandes.

Limitaciones de GitHub Enterprise Importer

  • Límite de tamaño de 40 GB para los archivos de repositorio (versión preliminar pública): Importer no puede migrar repositorios con más de 40 GB de datos y metadatos de git combinados en el archivo del repositorio.
  • 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 Administrar archivos 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 un repositorio.
  • 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 Introducción a una migración entre productos de 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 Acerca de los conjuntos de reglas.
  • 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 Reclamación de maniquíes para GitHub Enterprise Importer.

Introducción

Antes de migrar desde Bitbucket Server, debe planear cómo ejecutará la migración. Antes de migrar los datos, deberá elegir a alguien para ejecutar la migración. Debe conceder a esa persona el acceso necesario para el origen y el destino de la migración. También le recomendamos ejecutar primero una migración de prueba.

Para obtener información general sobre el proceso de migración de principio a fin, consulta Introducción a una migración de Bitbucket Server a GitHub Enterprise Cloud.