Skip to main content
Skip to content

Understand migrations from Azure DevOps to GitHub

GitHub Enterprise Importer can automate migrating from Azure DevOps.

About migrations from Azure DevOps Cloud

You can use GitHub Enterprise Importer to migrate repositories from Azure DevOps to GitHub Enterprise Cloud (GitHub.com or GHE.com).

You can only use GitHub Enterprise Importer to migrate from Azure DevOps Cloud, not from Azure DevOps Server. If you currently use Azure DevOps Server and want to migrate to GitHub, you can migrate to Azure DevOps Cloud first. For more information, see Migrate to Azure DevOps on the Azure site.

Before you create your enterprise account on GitHub, decide whether your enterprise will use Enterprise Managed Users. This affects how your members authenticate and how you manage identities and access. See Elección de un tipo de empresa para GitHub Enterprise Cloud.

To learn more about the differences between GitHub and Azure DevOps, see Key differences between Azure DevOps and GitHub.

Alternative tooling for migrations to GHE.com

This journey describes migrations with GitHub Enterprise Importer. If downtime is a concern, Enterprise Live Migrations is an alternative tool that keeps repositories available to developers for most of the migration. See Acerca de las migraciones en vivo de GitHub Enterprise Server a GHE.com.

ELM for Azure DevOps is in versión preliminar pública and only supports migrations to GHE.com, not GitHub.com. For more information, see Enterprise live migrations overview in the Microsoft Learn documentation.

Support for Azure Pipelines and Azure Boards

Both Azure Pipelines and Azure Boards can be fully integrated with your GitHub experience. You can configure your enterprise account and Azure DevOps so you can keep using these services while also benefitting from having your repositories hosted on GitHub.

If you want to migrate Azure Pipelines to GitHub Actions, contact your GitHub account manager.

Data that is migrated

GitHub Enterprise Importer currently supports migrating the following repository data from Azure DevOps to GitHub Enterprise Cloud.

  • Git source (including commit history)
  • Pull requests
  • User history for pull requests
  • Work item links on pull requests
  • Attachments on pull requests
  • Branch policies for the repository (user-scoped branch policies and cross-repo branch policies are not included)

Limitaciones de los datos migrados

Hay límites para lo que GitHub Enterprise Importer puede migrar. Algunos se deben a limitaciones de GitHub, mientras que otros son limitaciones de GitHub Enterprise Importer sí mismos.

Limitaciones de GitHub

  • 2 Límite de tamaño de GiB para una única confirmación de Git: Ninguna confirmación única en el repositorio de Git puede ser superior a 2 GiB. Si alguna de sus confirmaciones supera los 2 GiB, deberá dividir la confirmación en otras más pequeñas, cada una de 2 GiB o menos.
  • Límite de tamaño de 2 GiB para una sola inserción: Ninguna inserción única puede ser mayor que 2 GiB. Las inserciones más grandes producen un pack exceeds maximum allowed size error.
  • Límite de 255 bytes para las referencias de Git: Ninguna referencia de Git única, conocida normalmente como "ref", puede tener un nombre mayor que 255 bytes. Normalmente, esto significa que las referencias no pueden tener más de 255 caracteres, pero cualquier carácter que no sea ASCII, como emojis, puede consumir más de un byte. Si alguna de las referencias de Git es demasiado grande, devolveremos un mensaje de error claro.
  • Límite de tamaño de archivo MiB de 100: Después de completar la migración, ningún archivo único en el repositorio de Git puede ser mayor que 100 MiB. Durante la migración del repositorio, este límite aumenta a 400 MiB. Considere la posibilidad de usar Git LFS para almacenar archivos grandes.

Limitaciones de GitHub Enterprise Importer

  • Límite de tamaño de 40 GB para un repositorio de Git (versión preliminar pública): este límite solo se aplica al código fuente. Para comprobar si el archivo del repositorio supera el límite, use la herramienta git-sizer y revise el tamaño total del blob en la salida. La herramienta git-sizer también ayuda a identificar posibles problemas relacionados con archivos de gran tamaño, tamaño de blob, tamaño de confirmación y recuentos de árboles que podrían afectar a las migraciones.
  • Límite de tamaño de archivo MiB de 400: Al migrar un repositorio con GitHub Enterprise Importer, ningún archivo único en el repositorio de Git puede ser mayor que 400 MiB. Considere la posibilidad de usar Git LFS para almacenar archivos grandes.
  • **Git LFS objetos no migrados:**Importer puede migrar repositorios que usan Git LFS, pero los propios objetos LFS no se migrarán. Se pueden trasladar al destino de la migración como una tarea posterior una vez que se complete la migración.
  • Funcionalidad de búsqueda de código retrasada: volver a indexar el índice de búsqueda puede tardar unas horas después de migrar un repositorio y las búsquedas de código pueden devolver resultados inesperados hasta que se complete la nueva indexación.
  • Los conjuntos de reglas configurados para la organización pueden provocar errores en las migraciones: por ejemplo, si has configurado una regla que requiere que las direcciones de correo electrónico de los creadores de confirmaciones terminen en @monalisa.caty el repositorio que vas a migrar contiene confirmaciones que no cumplen esta regla, se producirá un error en la migración.
  • Es posible que el contenido de Mannequin no se pueda buscar: los maniquíes son usuarios de marcador de posición a los que está asociado el contenido importado (por ejemplo, problemas, solicitudes de incorporación de cambios, comentarios, etc.). Al buscar contenido asociado a un maniquí, como problemas asignados, es posible que no se encuentren los problemas. Una vez reclamado un maniquí, el contenido debe encontrarse a través del nuevo propietario.