Cette version de GitHub Enterprise Server n'est plus disponible depuis le 2026-04-09. Aucune publication de correctifs n’est effectuée, même pour les problèmes de sécurité critiques. Pour de meilleures performances, une sécurité améliorée et de nouvelles fonctionnalités, effectuez une mise à niveau vers la dernière version de GitHub Enterprise. Pour obtenir de l’aide sur la mise à niveau, contactez le support GitHub Enterprise.

Informations sur les migrations de Bitbucket Server vers GitHub Enterprise Cloud

Découvrez quelles données GitHub Enterprise Importer peuvent être migrées.

Dans cet article

À propos des migrations à partir de Bitbucket Server

Vous pouvez utiliser GitHub Enterprise Importer pour migrer des référentiels depuis Bitbucket Server vers GitHub Enterprise Cloud (GitHub.com ou GHE.com). Les migrations à partir de Bitbucket Server sont uniquement prises en charge pour Bitbucket Server ou Bitbucket Data Center version 5.14+ ou ultérieure.

Données migrées

Actuellement, nous prenons uniquement en charge la migration des données de dépôt suivantes depuis Bitbucket Server vers GitHub Enterprise Cloud.

  • Source Git (y compris l’historique des commits)

  • Requêtes de tirage (y compris les commentaires, les révisions de requête de tirage, les commentaires de révision de requête de tirage au niveau du fichier et de la ligne, les réviseurs requis et les pièces jointes)

    Remarque

    Les utilisateurs peuvent recevoir une erreur 500 lors de la tentative d’affichage d’une demande de tirage( pull request), si la demande de tirage a été fusionnée et que la branche de tête supprimée sur Bitbucket Server avant la migration. Bitbucket Server supprime des références Git spécifiques aux objets pour ces demandes de tirage, et par conséquent, ces objets Git associés à la demande de tirage ne peuvent pas être migrés.

Données non migrées

Actuellement, les données suivantes ne sont pas migrées.

  • Référentiels personnels détenus par les utilisateurs
  • Autorisations de branche
  • Commentaires de commit
  • Paramètres du référentiel
  • Pipelines CI

Limitations relatives aux données migrées

Il existe des limites à ce que GitHub Enterprise Importer peut migrer. Certaines sont dues à 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 255 octets pour les références Git : Aucune référence Git, communément appelée « ref », ne peut avoir un nom qui dépasse 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 tous les caractères non-ASCII, tels que les emojis, peuvent consommer plus d’un octet. 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 les fichiers volumineux. Pour plus d’informations, consultez « Gestion des fichiers volumineux ».

Limitations de GitHub Enterprise Importer

  •           **Limite de taille de 40 Gio pour les archives de référentiel (bêta) :** Le Importer ne peut pas migrer les référentiels avec plus de 40 Gio de données git combinées et de métadonnées dans l’archive du référentiel.
  • ** Limite de taille de fichier de 400 Mo :** lors de la migration d’un référentiel avec GitHub Enterprise Importer, aucun fichier de votre référentiel Git ne peut dépasser 400 Mo. Envisagez d’utiliser Git LFS pour stocker des gros fichiers. Pour plus d’informations, consultez « Gestion des fichiers volumineux ».
  • Objets Git LFS non migrés : Importer peut migrer les 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. Pour plus d’informations, consultez « Duplication d’un dépôt ».
  • Tâches de suivi requises : Lors de la migration entre produits GitHub, certains paramètres ne sont pas migrés et doivent être reconfigurés dans le nouveau dépôt. Pour obtenir la liste des tâches de suivi que vous devrez effectuer après chaque migration, consultez Vue d’ensemble d’une migration entre produits GitHub.
  • 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. Pour plus d’informations sur les ensembles de règles, consultez « À propos des ensembles de règles ».
  • Le contenu de mannequin ne peut pas être recherchable : les mannequins sont des utilisateurs d’espace réservé auxquels le contenu importé (tels que les problèmes, les demandes de tirage, 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. Pour plus d’informations, consultez « Récupération de modèles pour GitHub Enterprise Importer ».

Mise en route

Avant de migrer à partir de Bitbucket Server, vous devez planifier la façon dont vous allez exécuter votre migration. Avant de migrer des données, vous devez choisir quelqu’un pour exécuter la migration. Vous devez accorder à cette personne l’accès nécessaire pour la source et la destination de la migration. Pour commencer, nous vous recommandons également d'exécuter une migration d'essai.

Pour obtenir une vue d’ensemble du processus de migration du début à la fin, consultez Vue d’ensemble d’une migration de Bitbucket Server vers GitHub Enterprise Cloud.