CYBBACK

    Exporter et importer un projet GitLab : mode d'emploi et limites

    GitLab sait exporter un projet dans un fichier et le réimporter ailleurs. C'est un outil de migration : GitLab recommande plutôt le transfert direct pour migrer, et déconseille de se servir de ces fichiers comme sauvegarde.

    Par Product Marketing CYBBACK2 min de lectureVérifié le 14/11/2026

    Exporter un projet

    Il faut le rôle Maintainer ou Owner du projet.

    1. 1Ouvrez le projet.
    2. 2Allez dans Settings, General.
    3. 3Dépliez Advanced.
    4. 4Sélectionnez Export project.
    5. 5Quand l'export est prêt, suivez le lien de l'e-mail reçu, ou actualisez la page et sélectionnez Download export.

    Un traitement supprime ces fichiers d'export toutes les 24 heures : téléchargez-le rapidement.

    Importer le fichier

    Dans Create new, New project/repository, choisissez Import project, puis GitLab export, saisissez le nom et l'URL du projet, choisissez le fichier et validez avec Import project. Il faut le rôle Maintainer ou Owner sur le groupe de destination.

    La version de destination doit être identique ou plus récente que la source, et au plus deux versions mineures d'écart sont prises en charge. Sur GitLab.com, le fichier importé fait 5 Go au plus.

    Ce que l'export emporte, et ce qu'il laisse

    ExportéNon exporté
    Dépôt et wiki, fichiers téléversés, objets LFSVariables CI/CD, déclencheurs de pipeline, variables des planifications
    Tickets, merge requests, commentairesWebhooks et intégrations
    Étiquettes, jalons, extraits, releases, tableauxImages des registres de packages et de conteneurs
    Branches et tags protégés, règles de pushJournaux et artefacts des jobs
    Membres directs du projetJetons chiffrés, fichiers sécurisés, politiques de sécurité

    Les limites

    • GitLab l'écrit : il ne faut pas utiliser les fichiers d'export de projet pour sauvegarder ses données.
    • Selon les cas, les contributions des autres utilisateurs peuvent être attribuées à la personne qui importe.
    • Les liens entre tickets et vers les merge requests liées ne sont pas exportés.
    • Par défaut, l'export est limité à 6 projets par minute, et le téléchargement à 1 par projet et par minute.

    CYBBACK sauvegarde chaque nuit le code, le wiki, les tickets, les merge requests, les variables CI/CD avec leur valeur, les webhooks et les règles de protection, et restaure un projet ou un élément sans passer par un fichier d'export. Voir la solution GitLab.

    Questions fréquentes

    L'export de projet GitLab inclut-il les variables CI/CD ?

    Non. Les variables CI/CD, les déclencheurs de pipeline et les variables des planifications ne sont pas exportés.

    Peut-on utiliser l'export de projet comme sauvegarde ?

    GitLab le déconseille explicitement : il ne faut pas utiliser les fichiers d'export de projet pour sauvegarder ses données.

    Aller plus loin

    Les outils natifs couvrent les erreurs récentes. Pour garder des versions datées au-delà, restaurables et stockées en Europe ou chez vous, découvrez la sauvegarde CYBBACK.

    Sources officielles

    Faits vérifiés le 14/11/2026 dans la documentation officielle de l'éditeur :

    Guide indépendant, non affilié à l'éditeur de GitHub et GitLab. Les noms cités sont des marques de leurs propriétaires. Les interfaces évoluent : en cas de doute, la documentation officielle fait foi.

    À lire aussi