Aller au contenu

InsightsSoftware Factory

Migrer de Jira vers GitLab Issues, étape par étape

Ce que l'importeur Jira de GitLab reprend (titre, description, labels) et ce qu'il laisse (assignés, commentaires, sprints), les fonctions Premium dont dépend le mapping, le plan de migration en sept étapes et le serveur MCP pour vos agents. Vérifié au 22 novembre 2026.

Migrer de Jira vers GitLab Issues, étape par étape
SFEIR AI Rédaction humaine et IA · Comment nous écrivons
Publié le

Si votre code est sur GitLab, rapatrier les tickets au même endroit est la manière la plus directe de sortir de Jira. L'importeur natif fait une partie du travail : titre, description et labels. Il laisse de côté les assignés, les commentaires et les sprints, et les cibles d'un mapping propre (labels à portée, poids, itérations, epics, statuts) demandent GitLab Premium ou Ultimate. Ce guide vise une équipe qui migre ses projets Jira vers une instance GitLab, auto-hébergée ou non : ce que fait l'importeur, ce qu'il faut scripter, l'ordre des opérations et le branchement des agents une fois la bascule faite.

Que fait l'importeur Jira natif de GitLab ?

L'importeur est disponible sur toutes les éditions (Free, Premium, Ultimate) et toutes les offres (GitLab.com, Self-Managed, Dedicated). Il importe directement le titre, la description et les labels. Les métadonnées Jira sans champ GitLab équivalent sont ajoutées à la description, en texte brut. Avant l'import, vous associez les utilisateurs Jira aux membres du projet GitLab ; la liste déroulante propose par défaut la personne qui lance l'import. Les tickets de plusieurs projets Jira peuvent arriver dans un même projet GitLab1.

Prérequis :

  • un accès en lecture aux tickets Jira ;
  • le rôle Maintainer ou Owner sur le projet GitLab cible ;
  • l'intégration « Jira issues » configurée sur ce projet1.

L'import se lance depuis Work items, menu Actions, Import from Jira. Il tourne en tâche de fond : un gros projet prend plusieurs minutes, davantage si la file Sidekiq est chargée1. L'intégration accepte Jira Cloud comme Jira Data Center et Jira Server, versions 6.x à 10.x, avec un jeton personnel ou un couple identifiant et mot de passe pour les instances auto-hébergées2.

Que ne fait-il pas ?

Élément JiraImporteur natifSolution
Mise en formeTexte non converti en GitLab Flavored Markdown, mise en forme cassée possibleConversion ADF par script
Assignés, commentairesNon repris ; l'epic 2738 du projet GitLab propose de les ajouterScript sur l'API
Champs personnalisésEn texte brut dans la descriptionLabels à portée (champ::valeur) ou section de la description
Statuts et workflowsNon repris comme statutsStatuts de work items, à recréer
SprintsNon reprisItérations, créées d'abord dans le groupe
Pièces jointesNon mentionnées par la documentationScript sur l'API, à vérifier sur le pilote

L'import CSV est encore plus étroit. Seules les colonnes title, description, due_date, milestone et type sont lues ; le reste est ignoré. On peut placer des quick actions dans la description, une par ligne, pour fixer d'autres métadonnées, à condition que les labels et les jalons existent déjà et que les assignés soient membres du projet. Le fichier est limité à 10 Mo sur GitLab.com3.

La documentation ne décrit aucune reprise incrémentale de l'importeur Jira. Traitez chaque projet en un seul passage, après un essai sur un projet GitLab de test.

Quelles alternatives à l'importeur natif ?

La documentation GitLab liste plusieurs voies1 :

  • les Professional Services de GitLab, qui font la migration ;
  • Jira2Lab, le fork de jira2gitlab maintenu par ces Professional Services ;
  • un script tiers comme jira2gitlab ;
  • l'import CSV ;
  • un script maison sur les API REST ou GraphQL ;
  • un service de synchronisation, Unito ou Getint, qui garde Jira et GitLab alignés pendant la transition.

Dès que l'historique compte (commentaires, assignés, sprints), l'importeur natif ne suffit plus : un script, maison ou dérivé de Jira2Lab, devient nécessaire. Pour la mise en forme, la documentation donne, sur une instance que vous administrez, une conversion du format ADF de Jira vers GitLab Flavored Markdown dans la console Rails1 :

text = <document in Atlassian Document Format>
project = <project that wiki is in> or nil
Banzai.render(text, pipeline: :adf_commonmark, project: project)

L'ADF est le format dans lequel Jira Cloud stocke le texte des commentaires et des champs de texte long4. Depuis Jira Data Center, vérifiez sur le pilote le format que renvoie votre API : s'il s'agit du wiki markup de Jira, ce convertisseur ne s'applique pas et il faut une conversion dédiée.

Si vous préférez passer par des fichiers intermédiaires, relus et versionnés avant l'import, notre guide pour exporter ses tickets Jira en Markdown détaille cette voie.

Comment faire correspondre les concepts ?

La documentation GitLab propose un mapping pour les scripts1. La colonne « édition » est notre ajout, d'après la documentation de chaque fonction : elle décide de ce qui est faisable sur votre instance.

JiraGitLabÉdition
EpicEpic (work item de groupe)5Premium, Ultimate
Story, tâche, bugTicket (work item), avec un label de typeToutes
SprintItération, créée dans le groupe parent6Premium, Ultimate
Story pointsPoids (weight)7Premium, Ultimate
StatutStatut de work item8Premium, Ultimate
Priorité, champ à optionsLabel à portée (priority::1)9Premium, Ultimate
Champ texte ou numériqueSection dans la descriptionToutes
VersionJalon (milestone)Toutes

Sur une édition Free, comptez donc avec moins de structure : labels simples à la place des labels à portée, ticket chapeau à la place de l'epic, jalons à la place des sprints. Décidez le mapping avant le premier import.

Le plan de migration en sept étapes

  1. Inventorier : projets, volumétrie, champs personnalisés réellement remplis, apps et automatisations.
  2. Simplifier : supprimer les champs inutilisés, fusionner les statuts, décider du mapping et de l'édition GitLab nécessaire.
  3. Préparer GitLab : groupes, labels, comptes utilisateurs, et pour un script, les itérations dans le groupe parent. La documentation précise que la reprise des sprints vaut surtout pour les tickets non terminés ou planifiés dans un sprint futur1.
  4. Tester sur un projet pilote avec l'importeur natif, puis lister ce qui manque.
  5. Scripter le complément : commentaires, assignés, pièces jointes, liens, conversion ADF.
  6. Basculer par vagues, en passant chaque projet Jira en lecture seule une fois importé, pour éviter les modifications des deux côtés.
  7. Conserver la clé Jira (PROJ-123) dans le titre ou dans un label, pour retrouver l'historique et les références dans les commits.

Ce qui casse le plus souvent : un sprint perdu parce que l'itération n'existait pas au moment du script, des descriptions illisibles faute de conversion ADF, des utilisateurs Jira tous associés à la personne qui a lancé l'import, faute d'avoir revu la correspondance, et un mapping qui suppose des labels à portée sur une instance Free.

Comment brancher vos agents sur GitLab Issues ?

Le serveur MCP de GitLab est intégré à l'instance, à l'adresse https://<votre-instance>/api/v4/mcp. Il est en disponibilité générale depuis la 19.5 et disponible en Free depuis la 19.210. L'authentification passe par OAuth 2.0 avec enregistrement dynamique du client, ou par un jeton d'accès personnel à granularité fine ; les anciens jetons personnels, de projet ou de groupe sont refusés. Sur Self-Managed, un administrateur autorise l'accès au niveau de l'instance ; sur GitLab.com, le réglage se fait par groupe de premier niveau. Le jeu d'outils work_items est actif par défaut10. Depuis la 19.6, publiée le 19 novembre 2026, chaque action d'un agent passée par le serveur MCP crée un événement d'audit, consultable dans AI > Governance du groupe de premier niveau, et les propriétaires de ce groupe peuvent régler chaque outil sur Always Deny, Always Ask ou Always Allow, une fonction encore en bêta11.

Claude Code, Cursor, Codex, Gemini CLI ou OpenCode, entre autres clients, lisent et mettent ensuite à jour les tickets10. Sur un GitLab privé, l'agent interroge votre instance sans passer par un SaaS tiers. Le CLI glab reste utile pour les scripts de migration.

Dans l'autre sens, GitLab Duo peut appeler des serveurs MCP externes depuis Agentic Chat et le Software Development Flow. La fonction est activée par défaut depuis la 18.2 et en disponibilité générale depuis la 18.8. Il faut cocher « Allow external MCP tools » dans le groupe de premier niveau où Duo est configuré, et les serveurs se déclarent dans .gitlab/duo/mcp.json. Sur Self-Managed, un administrateur doit en plus activer le feature flag mcp_client pour que les agents et flows personnalisés utilisent ces outils externes12. Pour aller plus loin sur le contexte que GitLab expose aux agents, lisez notre analyse d'Orbit et de son graphe de contexte.

Questions fréquentes

L'importeur GitLab importe-t-il les commentaires ?

Non. Ni les commentaires ni les assignés ne sont repris ; leur ajout est proposé dans l'epic 2738 du projet GitLab1. Il faut un script sur l'API pour les rapatrier.

Peut-on importer depuis Jira Data Center ?

Oui. L'intégration Jira de GitLab accepte Jira Data Center et Jira Server, versions 6.x à 10.x, avec un jeton personnel ou une authentification basique2.

Faut-il GitLab Premium ?

Pas pour l'importeur ni pour le serveur MCP. Les epics, les itérations, les poids, les statuts de work items et les labels à portée demandent en revanche Premium ou Ultimate.

Peut-on garder Jira et GitLab synchronisés pendant la transition ?

Oui, avec un service tiers comme Unito ou Getint, cités par la documentation GitLab1. Limitez cette période : chaque ticket modifié des deux côtés devient un conflit à arbitrer.

Un mapping décidé avant le premier import

L'importeur natif suffit pour un premier test. Une migration propre demande un script complémentaire, un mapping décidé en amont et une édition GitLab choisie en conséquence. Pour la cible au-delà de GitLab Issues, avec un backlog Markdown dans le repo pour les équipes équipées d'agents, lisez notre recommandation pour une organisation sur GitLab privé. Si votre choix d'outil n'est pas encore arrêté, notre comparatif des alternatives à Jira auto-hébergées met GitLab face à OpenProject, Plane et Tuleap.

Sources

  1. GitLab Docs, « Migrate from Jira », consulté le 22 novembre 2026. docs.gitlab.com
  2. GitLab Docs, « Jira issues integration », consulté le 22 novembre 2026. docs.gitlab.com
  3. GitLab Docs, « Import issues from a CSV file », consulté le 22 novembre 2026. docs.gitlab.com
  4. Atlassian Developer, « Atlassian Document Format » (structure), consulté le 22 novembre 2026. developer.atlassian.com
  5. GitLab Docs, « Epics », consulté le 22 novembre 2026. docs.gitlab.com
  6. GitLab Docs, « Iterations », consulté le 22 novembre 2026. docs.gitlab.com
  7. GitLab Docs, « Work item weight », consulté le 22 novembre 2026. docs.gitlab.com
  8. GitLab Docs, « Status », consulté le 22 novembre 2026. docs.gitlab.com
  9. GitLab Docs, « Labels » (section « Scoped labels »), consulté le 22 novembre 2026. docs.gitlab.com
  10. GitLab Docs, « GitLab MCP server », consulté le 22 novembre 2026. docs.gitlab.com
  11. GitLab, « GitLab 19.6 release notes », 19 novembre 2026. docs.gitlab.com
  12. GitLab Docs, « GitLab MCP clients », consulté le 22 novembre 2026. docs.gitlab.com

Passer à l’action

Sortir de Jira : par où commencer ?

Nous partons de votre inventaire Jira pour décider du mapping vers GitLab et du découpage de la bascule par vagues.

Demander un Diagnostic 10x