Importer un dépôt externe vers GitLab pour migrer vos projets

Transférez vos projets Bitbucket ou GitHub vers GitLab en conservant tout l'historique grâce aux outils d'importation.

Importer un dépôt externe vers GitLab : Migrer vos projets

Pourquoi importer vos dépôts existants ?

Dans la vie d'un projet, il est fréquent de devoir changer d'hébergeur pour profiter de meilleures fonctionnalités ou centraliser ses outils. Importer un dépôt externe vers GitLab permet de migrer tout votre travail depuis une plateforme tierce comme Bitbucket vers GitLab sans perdre votre précieux historique de modifications.

L'importation agit comme un déménagement professionnel : vous déplacez toute la structure, les commits et les branches. GitLab facilite cette transition grâce à des connecteurs natifs qui automatisent presque tout le processus de migration.

Lancer la procédure d'importation

L'importation commence directement depuis votre tableau de bord GitLab, en utilisant les outils de migration intégrés plutôt que de créer un projet vide.

Accéder à l'outil d'importation

Une fois connecté, cliquez sur le bouton New project. Au lieu de choisir un projet "Blank", sélectionnez l'onglet Import project.

Bouton New Project GitLab

"Le point de départ pour importer un projet existant"

Sélectionner la source Bitbucket

Une liste de plateformes s'affiche. Cliquez sur le bouton Bitbucket Cloud (ou Server selon votre infrastructure).

Sélection de Bitbucket comme source d'import

Authentification et autorisation

Pour que GitLab puisse récupérer votre code, il doit obtenir votre permission explicite d'accéder à votre compte externe.

Se connecter à Bitbucket

GitLab vous redirige vers la page de connexion de Bitbucket pour saisir vos identifiants.

Page de connexion Bitbucket

Autoriser l'accès aux données

Une fois connecté, cliquez sur Grant access (Accorder l'accès). Cela permet à GitLab de lire vos informations de compte, vos tickets et le contenu de vos dépôts pour réussir la migration Bitbucket vers GitLab.

Demande d'autorisation Bitbucket

"Cette étape sécurisée crée un pont entre les deux plateformes"

Finaliser la migration du projet

Une fois la connexion établie, GitLab liste tous les dépôts disponibles sur votre compte source.

Choisir le projet à importer

Cherchez le projet à migrer dans la liste et cliquez sur le bouton bleu Import.

Lancement de l'importation

Vérification de la réussite

Une barre de progression s'affiche. Une fois le transfert terminé, le statut passera à Done. Votre projet est désormais hébergé sur GitLab avec son historique complet.

Résultat de l'importation :

Importing... 100%
Status: Done
Project 'mon-app-web' is now available on GitLab.

Information sur les branches

Par défaut, GitLab nommera votre branche principale main. Si votre dépôt source utilisait encore le nom "master", GitLab s'occupe généralement de faire la correspondance automatiquement.

Conclusion

Savoir importer un dépôt externe vers GitLab est une compétence clé pour centraliser vos actifs numériques au sein d'une seule forge logicielle DevOps.

Maintenant que vos projets sont en place, il est temps d'explorer l'automatisation. Dans le prochain chapitre, nous ferons nos premiers pas avec l'Intégration Continue via GitLab CI.

Espace commentaire

Écrire un commentaire

Vous devez être connecté pour poster un message !

16 commentaires

Membre

actif

23/04/26

On avait quelques doutes sur la rétention de l'historique après transfert, c'est rassurant

Membre

actif

23/04/26

Merci pour le pas à pas, on l'a suivi à la lettre et zéro problème

Membre

actif

23/04/26

J'ai fait la migration hier et c'est passé comme une lettre à la poste

la section sur la vérification de la réussite est un must have pour la tranquillité d'esprit

Membre

actif

23/04/26

Génial le focus sur la sélection de la source Bitbucket, ça évite les confusions

Membre

actif secouriste

23/04/26

Excellent pour la migration Bitbucket vers GitLab

Membre

actif rédacteur

23/04/26

le guide sur l'importation de dépôts externes est super clair

23/04/26

On était bloqués sur l'authentification Bitbucket

Vos étapes pour autoriser l'accès aux données ont débloqué notre projet, merci

Membre

actif

23/04/26

Vraiment utile de garder tout l'historique lors de la migration du projet

Membre

actif

23/04/26

J'apprécie la section sur pourquoi importer vos dépôts existants, bonne piqûre de rappel

Membre

actif

23/04/26

La procédure d'importation est bien détaillée, on peut pas se louper

Membre

actif

23/04/26

On vient de finaliser une migration et la vérification de la réussite est top

pas de surprise, tout est passé nickel, belle doc

Membre

actif

23/04/26

Super pour choisir le projet à importer, simple et efficace

Membre

actif secouriste

23/04/26

On utilise les outils d'importation GitLab depuis un moment, ça nous sauve la vie

Membre

actif

23/04/26

La partie sur comment se connecter à Bitbucket est très claire

Membre

actif

23/04/26

Ce guide va nous faire gagner un temps fou sur nos prochaines consolidations de projets

La clarté sur l'autorisation d'accès aux données est précieuse

Membre

actif

23/04/26

Nickel pour accéder à l'outil d'importation direct au bon endroit

Rejoindre la communauté

Recevoir les derniers articles gratuitement en créant un compte !

S'inscrire