Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.

À propos des migrations

Le processus de migration consiste à transférer des données d’un emplacement source (organisation GitHub.com ou instance GitHub Enterprise Server) vers une instance GitHub Enterprise Server cible.

Types de migrations

Vous pouvez effectuer trois types de migrations :

  • Une migration d’une instance de GitHub Enterprise Server vers une autre instance GitHub Enterprise Server existante. Vous pouvez migrer n’importe quel nombre de dépôts appartenant à un utilisateur ou une organisation sur l’instance. Avant d’effectuer une migration, vous devez disposer d’un accès administrateur de site aux deux instances.
  • Une migration d’une organisation GitHub.com vers une instance de GitHub Enterprise Server. Vous pouvez migrer n’importe quel nombre de dépôts appartenant à l’organisation. Avant d’effectuer une migration, vous devez disposer d’un accès administratif à l’organisation GitHub.com et d’un accès administrateur de site à l’instance cible.
  • Les essais sont des migrations qui importent des données dans une instance de préproduction. Ils vous permettent de voir ce qui se passerait si une migration était appliquée à your GitHub Enterprise Server instance. Nous vous recommandons vivement d’effectuer un essai sur une instance intermédiaire avant d’importer des données dans votre instance de préproduction.

Remarque : L’utilisation de l’outil de migration n’est pas recommandée pour transférer une instance GitHub Enterprise Server d’un hyperviseur à un autre. Nous vous suggérons plutôt de sauvegarder et de restaurer dans le nouvel emplacement avec GitHub Enterprise Server Backup Utilities, ou de créer un réplica dans le nouvel emplacement, puis de basculer vers l’appliance réplica. Pour plus d’informations, consultez « Configuration des sauvegardes sur votre appliance », « Création d’un réplica haute disponibilité » et « Lancement d’un basculement vers votre appliance réplica ».

Données migrées

Dans le cadre d’une migration, tout tourne autour d’un dépôt. La plupart des données associées à un dépôt peuvent être migrées. Par exemple, un dépôt dans une organisation migre le dépôt et l’organisation ainsi que tous les utilisateurs, équipes, problèmes et demandes de tirage (pull request) associés au dépôt.

Les éléments du tableau ci-dessous peuvent être migrés avec un dépôt. Les éléments qui ne figurent pas dans la liste des données migrées ne peuvent pas être migrés, notamment les ressources Git LFS.

Remarque : les relations de duplication ne persistent pas après une migration.

Données associées à un dépôt migréNotes
UtilisateursLes @mentions d’utilisateurs sont réécrites pour correspondre à la cible.
OrganisationsLe nom et les détails d’une organisation sont migrés.
RéférentielsLes liens vers les arborescences, blobs, commits et lignes Git sont réécrits pour correspondre à la cible. L’outil de migration suit un maximum de trois redirections de dépôt. Les référentiels internes sont migrés en tant que dépôts privés. L’état de l’archive n’est pas défini.
WikisToutes les données wiki sont migrées.
TeamsLes @mentions d’équipes sont réécrites pour correspondre à la cible.
Étapes majeuresLes horodatages sont conservés.
Tableaux de projetLes tableaux de projet associés au dépôt et à l’organisation qui possède le dépôt sont migrés.
ProblèmesLes références de problème et les horodatages sont conservés.
Commentaires de problèmeLes références croisées aux commentaires sont réécrites pour l’instance cible.
Demandes de tirageLes références croisées aux demandes de tirage sont réécrites pour correspondre à la cible. Les horodatages sont conservés.
Revues de demande de tirageLes revues de demande de tirage et les données associées sont migrées.
Commentaires de revues de demande de tirageLes références croisées aux commentaires sont réécrites pour l’instance cible. Les horodatages sont conservés.
Commentaires de commitLes références croisées aux commentaires sont réécrites pour l’instance cible. Les horodatages sont conservés.
VersionsToutes les données de versions sont migrées.
Actions effectuées sur les demandes de tirage ou les problèmesToutes les modifications apportées aux demandes de tirage ou aux problèmes, notamment l’attribution d’utilisateurs, le renommage des titres et la modification d’étiquettes, sont conservées ainsi que les horodatages pour chaque action.
Pièces jointesLes fichiers joints aux problèmes et demandes de tirage sont migrés. Vous pouvez désactiver la migration de ces éléments.
WebhooksSeuls les webhooks actifs sont migrés.
Clés de déploiement de dépôtLes clés de déploiement de dépôt sont migrées.
Branches protégéesLes paramètres de branche protégée et les données associées sont migrés.