La migration par transfert direct est désormais disponible

La migration des groupes et projets GitLab par transfert direct est désormais disponible dans la version GitLab 18.3. Il s'agit d'une méthode simple et automatisée pour migrer des ressources GitLab entre instances GitLab vers un public encore plus large.

Le transfert direct vous permet de créer facilement une copie des ressources GitLab de votre choix sur la même instance ou sur une autre instance GitLab. Vous pouvez utiliser l'interface utilisateur (intuitive et simple d'utilisation), ou l'API qui offre une flexibilité supplémentaire pour choisir les ressources à copier.

La migration par transfert direct représente une amélioration majeure par rapport à la migration de groupes et de projets via l'exportation de fichiers pour les raisons suivantes :

• Vous n'avez plus besoin d'exporter manuellement chaque groupe et projet individuel vers un fichier, puis d'importer tous ces fichiers vers un nouvel emplacement. Désormais, il vous suffit de migrer directement tout groupe de niveau supérieur dont vous avez le rôle de propriétaire avec tous ses sous-groupes et projets.
• La migration par transfert direct permet le mappage des contributions utilisateur après l'importation (comme la paternité des tickets ou des commentaires), pour plus de flexibilité et de contrôle.
• Elle fonctionne de manière fiable avec des projets volumineux. Grâce au traitement par lots des ressources et à l'exécution simultanée des processus d'importation et d'exportation, les risques d'interruption ou de délai d'attente dépassé sont considérablement réduits.
• Elle offre une meilleure visibilité sur la migration pendant son exécution ainsi qu'après sa finalisation. Dans l'interface utilisateur, vous pouvez observer l'augmentation du nombre de fichiers à mesure que de nouveaux éléments sont importés. Ensuite, vous pouvez vérifier les résultats de l'importation. Les éléments importés sont indiqués par le badge Imported dans l'interface utilisateur GitLab.

Nous avons parcouru un long chemin depuis GitLab 14.3, lorsque nous avons commencé à prendre en charge la migration directe des ressources de groupe. Dans GitLab 15.8, nous avons étendu cette fonctionnalité aux projets en version bêta. Depuis, nous avons travaillé à améliorer l'efficacité et la fiabilité de l'importation, en particulier pour les projets volumineux. Nous avons également minutieusement testé la sécurité et la stabilité des instances de cette nouvelle fonctionnalité.

Voici deux exemples d'importations réussies qui illustrent la taille des groupes et des projets que nous avons testés, ainsi que leur durée d'importation :

• 100 projets (19 900 tickets, 83 000 merge requests, plus de 100 000 pipelines) migrés en 8 heures
• 1 926 projets (22 000 tickets, 160 000 merge requests, 1,1 million de pipelines) migrés en 34 heures

Sur GitLab.com, la migration par transfert direct est activée par défaut, tandis que sur GitLab Self-Managed et sur GitLab Dedicated, un administrateur doit activer la fonctionnalité dans les paramètres de l'application.

Quand utiliser la migration par transfert direct et comment obtenir les meilleurs résultats ?

La migration par transfert direct nécessite une connexion réseau entre les instances ou GitLab.com. Par conséquent, les clients qui utilisent des réseaux air-gapped sans connectivité entre leurs instances GitLab doivent toujours utiliser l'exportation de fichiers pour copier leurs données GitLab. Ils pourront utiliser la migration de groupes et de projets par transfert direct lorsque cette solution prendra en charge les instances hors ligne.

Avant toute migration, consultez notre documentation, y compris les prérequis, les éléments de groupe et les éléments de projet qui sont migrés. Certains éléments sont exclus de la migration ou ne sont pas encore pris en charge.

Migrez entre les versions les plus récentes possibles

Nous recommandons de migrer entre des versions aussi récentes que possible. Mettez à jour les instances source et destination pour profiter de toutes les améliorations et corrections de bogues que nous avons ajoutées au fil du temps.

Préparez-vous au mappage des contributions utilisateur après la migration

Familiarisez-vous avec le processus de mappage des contributions et des appartenances utilisateur afin de connaître les prochaines étapes à suivre une fois la migration terminée.

Examinez les options pour réduire la durée de migration

Selon l'endroit où vous migrez (GitLab.com, une instance Self-Managed ou Dedicated) vous pouvez appliquer diverses stratégies pour réduire la durée de migration.

Comment puis-je examiner les résultats ?

Vous pouvez consulter tous les groupes et projets que vous avez migrés par transfert direct sur la page d'historique d'importation de groupe. Pour chaque groupe et projet, vous avez la possibilité d'afficher les statistiques des éléments importés et d'examiner plus en détails les éléments qui n'ont pas été importés. Vous pouvez également utiliser les points de terminaison API pour faire de même.

Dans les cas où la plupart de vos projets se sont terminés avec succès, mais que certaines relations manquent encore dans un ou deux projets, comme des merge requests ou des tickets, nous vous recommandons d'essayer de réimporter ces projets avec l'API.

Quelle est la prochaine étape pour la migration par transfert direct ?

Nous sommes ravis de proposer la migration par transfert direct et espérons que cette amélioration vous plaira ! Nous souhaitons connaître votre avis. Quelle est la fonctionnalité qui, selon vous, manque encore ? Que pouvons-nous améliorer ? Faites-le nous savoir dans ce ticket et nous continuerons à itérer !