Créer un ticket Work item sur GitLab pour organiser votre travail

Utilisez le système de tickets GitLab pour traquer les bugs, planifier des tâches et collaborer efficacement.

Créer un ticket (Work item) sur GitLab : Organiser votre travail

C'est quoi une "Work item" et à quoi ça sert ?

Dans le monde du développement, on ne travaille jamais au hasard. Pour garder une trace des bugs à corriger, des nouvelles fonctionnalités à créer ou des tâches à accomplir, GitLab utilise un système de tickets, appelés Work items.

Imaginez qu'une issue est comme un Post-it intelligent sur un tableau de bord collaboratif. Contrairement à un simple papier, ce ticket peut contenir une description détaillée, des images, être assigné à une personne précise et posséder une date limite. C'est l'outil central pour organiser le travail de l'équipe et s'assurer que rien n'est oublié.

Les étapes pour créer votre premier ticket

La création d'un ticket se fait directement depuis l'interface web de GitLab. Voici la marche à suivre pour signaler un problème ou une idée de génie.

Accéder à votre projet

Connectez-vous à votre compte et rendez-vous sur la page d'accueil du projet concerné.

Sélection du projet dans GitLab

Ouvrir l'onglet des tickets

Dans le menu latéral de gauche, cliquez sur l'onglet Work items. Vous verrez alors la liste des tickets déjà ouverts (si le projet n'est pas vide). Pour en créer un nouveau, cliquez sur le bouton bleu New issue en haut à droite.

Bouton New Work item dans GitLab

"Le bouton New issue permet d'ouvrir le formulaire de création"

Remplir les informations du ticket

Un formulaire s'affiche. Pour qu'un ticket soit utile, il doit être parfaitement renseigné :

  • Type : Permet de définir s'il s'agit d'un ticket classique (Issue) ou d'un autre type de tâche. C'est la base pour organiser votre flux de travail.
  • Title : Donnez un nom clair et percutant (ex : "Bug : erreur 404 sur la page contact"). C'est le champ obligatoire pour créer un ticket GitLab.
  • Description : Utilisez l'éditeur riche pour expliquer le problème. Vous pouvez glisser-déposer des images ou insérer des extraits de code pour être le plus précis possible.
  • Assignee : Choisissez le collaborateur qui doit résoudre la tâche. L'option "assign yourself" permet de vous l'attribuer instantanément.
  • Labels : Ajoutez des étiquettes colorées (bug, feature, urgent) pour catégoriser vos tickets et les filtrer en un clin d'œil.
  • Milestone : Rattachez le ticket à un jalon temporel pour l'inclure dans vos objectifs de livraison ou vos Sprints.
  • Dates : Indiquez précisément une date de début et une date d'échéance (Due date) pour garantir le respect de votre calendrier de développement.
Formulaire de création de ticket GitLab

Une fois le formulaire rempli, cliquez sur le bouton Create issue en bas de page.

Visualiser le ticket créé

Votre ticket possède désormais un numéro unique (par exemple #1). Tout le monde peut maintenant commenter ce ticket pour donner des précisions ou indiquer que le travail avance.

Aperçu du ticket créé

"Chaque ticket devient un espace de discussion dédié à une tâche précise"

Le conseil du pro

Prenez l'habitude de créer un ticket avant de commencer à coder. Cela permet de centraliser les échanges et d'éviter que deux personnes ne fassent la même chose en même temps.

Conclusion

Le système de tickets est le moteur de la collaboration sur GitLab. Bien utiliser les Work items permet de transformer une liste de bugs désordonnée en un plan d'action clair et professionnel.

Une fois qu'un ticket est créé et que vous avez fini de coder la solution, il est temps de proposer votre travail pour qu'il soit intégré au projet. Pour cela, nous allons utiliser une Merge Request. C'est l'étape cruciale que nous allons découvrir dans le prochain chapitre.

Espace commentaire

Écrire un commentaire

Rejoignez la discussion

Vous devez être connecté pour poster un message.

20 commentaires

ajdaini-hatim
Auteur Rédacteur Secouriste Actif
Avatar de ajdaini-hatim
ajdaini-hatim
Auteur Rédacteur Secouriste Actif

Pas de souci. Pensez à utiliser les Labels avec des couleurs distinctes, ça change la vie pour le triage rapide.

10/05/2026 à 15:03
hdasilva
Membre
Avatar de hdasilva
hdasilva
Membre

Merci pour le guide. Ça aide les nouveaux qui arrivaient pas à trier les bugs.

10/05/2026 à 07:34
ajdaini-hatim
Auteur Rédacteur Secouriste Actif
Avatar de ajdaini-hatim
ajdaini-hatim
Auteur Rédacteur Secouriste Actif

Le Milestone c'est le cadre temporel global (Sprint), la Due date c'est la deadline spécifique pour ce ticket précis. Faut utiliser les deux pour être propre.

10/05/2026 à 02:39
xcoste
Membre Actif
Avatar de xcoste
xcoste
Membre Actif

C'est quoi la différence entre Due date et Milestone ? Je mélange tout.

09/05/2026 à 20:54
ajdaini-hatim
Auteur Rédacteur Secouriste Actif
Avatar de ajdaini-hatim
ajdaini-hatim
Auteur Rédacteur Secouriste Actif

Il faut être en version Premium pour les multiples assignés. En version gratuite, un seul c'est la règle. Sinon, utilisez les mentions dans les commentaires.

09/05/2026 à 15:27
gilbert33
Membre
Avatar de gilbert33
gilbert33
Membre

Comment on assigne plusieurs personnes sur un seul ticket ? Impossible de sélectionner plus d'un Assignee.

09/05/2026 à 10:05
ajdaini-hatim
Auteur Rédacteur Secouriste Actif
Avatar de ajdaini-hatim
ajdaini-hatim
Auteur Rédacteur Secouriste Actif

Si tes logs sont trop gros, ne pollue pas le ticket. Fais un gist ou un fichier joint. Utilise plutôt cette commande pour extraire le nécessaire :

grep -i "error" server.log | tail -n 20 > debug.txt
09/05/2026 à 04:21
christine-charrier
Membre Actif
Avatar de christine-charrier
christine-charrier
Membre Actif

Sympa l'article. Par contre, les Work items sont limités en taille de description ? J'ai des logs énormes à coller dedans.

08/05/2026 à 21:51
ajdaini-hatim
Auteur Rédacteur Secouriste Actif
Avatar de ajdaini-hatim
ajdaini-hatim
Auteur Rédacteur Secouriste Actif

Tu ne supprimes pas un ticket, tu le fermes. Si c'est vraiment sensible, faut supprimer le projet ou contacter ton admin à ne jamais laisser traîner en clair.

08/05/2026 à 14:55

Comment on fait pour supprimer un ticket ? J'ai fait une boulette avec un titre contenant des infos sensibles.

08/05/2026 à 07:52
ajdaini-hatim
Auteur Rédacteur Secouriste Actif
Avatar de ajdaini-hatim
ajdaini-hatim
Auteur Rédacteur Secouriste Actif

Exact. Si le milestone est fermé, il dégage des vues par défaut. Vérifie l'état dans la section Milestones de ton projet.

08/05/2026 à 03:07
leon-gimenez
Membre Actif
Avatar de leon-gimenez
leon-gimenez
Membre Actif

Vérifie si ton milestone n'est pas archivé. Ça m'est arrivé la semaine dernière, j'ai cherché une heure pour rien.

07/05/2026 à 19:45
dfouquet
Membre
Avatar de dfouquet
dfouquet
Membre

Le Milestone ne s'affiche pas sur mon board, alors qu'il est bien assigné. Une idée ?

07/05/2026 à 13:50
ajdaini-hatim
Auteur Rédacteur Secouriste Actif
Avatar de ajdaini-hatim
ajdaini-hatim
Auteur Rédacteur Secouriste Actif

GitLab Community ne permet pas de customiser les champs du formulaire nativement. Soit tu passes par les Issue Templates en markdown, soit tu payes la version Premium pour les champs personnalisés.

07/05/2026 à 06:23
gseguin
Membre Actif
Avatar de gseguin
gseguin
Membre Actif

Quelqu'un sait comment forcer un champ personnalisé dans le formulaire New issue ? On a besoin d'un champ obligatoire pour la version logicielle.

07/05/2026 à 00:29
ajdaini-hatim
Auteur Rédacteur Secouriste Actif
Avatar de ajdaini-hatim
ajdaini-hatim
Auteur Rédacteur Secouriste Actif

C'est pas un bug, c'est juste le cache. Vérifiez aussi que le label est bien scope au projet et pas au groupe, sinon il ne remontera pas dans la liste.

06/05/2026 à 18:40
julie83
Membre
Avatar de julie83
julie83
Membre

Même problème ici. Il faut parfois rafraîchir la page après la création du label, c'est super mal foutu sur certaines versions de GitLab.

06/05/2026 à 12:21
blemoine
Membre
Avatar de blemoine
blemoine
Membre

J'ai un souci avec les Labels. Quand j'en crée un, il n'apparaît pas dans la liste déroulante lors de la création du ticket. C'est un bug ou je suis aveugle ?

06/05/2026 à 06:27
ajdaini-hatim
Auteur Rédacteur Secouriste Actif
Avatar de ajdaini-hatim
ajdaini-hatim
Auteur Rédacteur Secouriste Actif

Faut arrêter de vouloir tout cliquer. Utilise l'API v4 avec un PRIVATE-TOKEN. Voici le endpoint pour poster ton ticket en auto :

curl --request POST --header "PRIVATE-TOKEN: <ton_token>" "https://gitlab.example.com/api/v4/projects/<id>/issues?title=Bug+auto&description=Log+erreur"
06/05/2026 à 01:34
qcollin
Membre Actif
Avatar de qcollin
qcollin
Membre Actif

Tuto utile pour les débutants. Par contre, comment on fait pour automatiser la création via API ? Le clic manuel c'est bien, mais pour nos scripts de monitoring, c'est mort.

05/05/2026 à 18:54

Rejoindre la communauté

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

S'inscrire