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 Choix d’un type d’entreprise pour 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 À propos des migrations dynamiques de GitHub Enterprise Server vers GHE.com.

ELM for Azure DevOps is in préversion publique 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)

Limitations relatives aux données migrées

Il existe des limites à ce que GitHub Enterprise Importer peut migrer. Certains sont dus à des limitations de GitHub, tandis que d’autres sont des limitations de GitHub Enterprise Importer lui-même.

Limitations de GitHub

  • Limite de taille de 2 Gio pour une validation Git unique : Aucune validation unique dans votre référentiel Git ne peut être supérieure à 2 Gio. Si l’une de vos validations est supérieure à 2 Gio, vous devez fractionner la validation en validations plus petites qui sont chacune de 2 Gio ou plus petites.
  • Limite de taille de 2 Gio pour un seul push : Aucun push unique ne peut être supérieur à 2 Gio. Les push plus volumineux échouent avec une pack exceeds maximum allowed size erreur.
  • Limite de 255 octets pour les références Git : Aucune référence Git unique, communément appelée « ref », ne peut avoir un nom supérieur à 255 octets. En règle générale, cela signifie que vos références ne peuvent pas contenir plus de 255 caractères, mais que les caractères non ASCII, tels que les emojis, peuvent consommer plusieurs octets. Si l’une de vos références Git est trop grande, nous retournons un message d’erreur clair.
  • Limite de taille de fichier MiB 100 : Une fois votre migration terminée, aucun fichier unique dans votre référentiel Git ne peut être supérieur à 100 Mio. Pendant la migration du référentiel, cette limite est augmentée à 400 Mio. Envisagez d’utiliser Git LFS pour stocker des fichiers volumineux.

Limitations de GitHub Enterprise Importer

  • Limite de taille de 40 Go pour un référentiel Git (préversion publique) : Cette limite s'applique uniquement au code source. Pour vérifier si l’archive du référentiel dépasse la limite, utilisez l’outil git-sizer et passez en revue la taille totale de l’objet blob dans la sortie. L’outil git-sizer permet également d’identifier les problèmes potentiels liés aux fichiers volumineux, à la taille d’objet blob, à la taille de validation et aux nombres d’arborescences susceptibles d’avoir un impact sur les migrations.
  • Limite de taille de fichier de 400 Mio : Lors de la migration d’un référentiel avec GitHub Enterprise Importer, aucun fichier unique de votre référentiel Git ne peut dépasser 400 Mio. Envisagez d’utiliser Git LFS pour stocker des fichiers volumineux.
  • **Git LFS objets non migrés :**Importer peut migrer des dépôts qui utilisent Git LFS, mais les objets LFS eux-mêmes ne seront pas migrés. Ils peuvent être poussés vers votre destination de migration en tant que tâche de suivi une fois la migration terminée.
  • Fonctionnalité de recherche de code différée : La réindexation de l’index de recherche peut prendre quelques heures après la migration d’un dépôt, et les recherches de code peuvent retourner des résultats inattendus tant que la réindexation n’est pas terminée.
  • Les ensembles de règles configurés pour votre organisation peuvent entraîner l’échec des migrations : Par exemple, si vous avez configuré une règle qui exige que les adresses e-mail des auteurs de commit se terminent par @monalisa.cat, et que le dépôt que vous migrez contient des commits qui ne sont pas conformes à cette règle, votre migration échoue.
  • Le contenu des utilisateurs fictifs pourrait ne pas être accessible à la recherche : les utilisateurs fictifs sont des utilisateurs d’espace réservé auxquels le contenu importé (tel que les problèmes, les pull requests, les commentaires, etc.) est associé. Lorsque vous recherchez du contenu associé à un mannequin, tel que des problèmes attribués, ces problèmes peuvent ne pas être trouvés. Une fois qu’un mannequin est récupéré, le contenu doit être trouvé via le nouveau propriétaire.