Intégration entre Tuleap et Gitlab

L’intégration Tuleap-GitLab vous permet de vous connecter à n’importe quelle instance GitLab, que vous soyez dans le cloud ou sur-site. Cette intégration sert notamment à ceux qui utilisent GitLab pour créer du code planifié et qui font leur suivi dans Tuleap. Il est désormais beaucoup plus simple d’utiliser les deux outils ensembles. Maintenant, découvrez plus en détail pourquoi et surtout comment l’utiliser.


Tuleap + Gitlab : pourquoi utiliser les deux outils ensemble

Il est vrai que dans une certaine mesure, Tuleap et GitLab peuvent être considérés comme « concurrents », ou du moins comme des « alternatives ». Mais outre le fait que les deux outils fournissent du Git et des outils de suivi de tickets, nous dirions qu’ils sont en fait plutôt complémentaires :

Avec Tuleap : vous rassemblez une large audience autour d’un seul outil de gestion de projet. En plus de l’équipe de devs, Tuleap est adapté à des projets plus complets, à la gestion de programmes, aux tests et gestion des exigences, permet de stocker de la doc… et plus encore

Avec GitLab : votre équipe de développement bénéficie des meilleures pipelines de CI/CD et d’une vue centralisée des repos Git qu’ils ont l’habitude d’avoir avec GitHub.

Vous l’aurez compris, en utilisant les deux outils ensembles, vous obtiendrez le meilleur des deux mondes. C’est pourquoi nous avons pensé qu’il était temps de vous présenter plus en détails notre intégration GitLab.

Comment fonctionne l’intégration Tuleap-Gitlab

Avant tout, il faut savoir que chaque projet Tuleap peut soit :

Gestion complète dans la plateforme Tuleap

Tuleap fournit un plugin GitLab dédié qui fera tout le travail nécessaire pour que les choses fonctionnent de manière transparente. Sur GitLab, cette intégration n’a pas de contrainte spécifique ; mieux, elle fonctionne à l’aide d’API standard disponibles sur toutes les versions de GitLab, sur site ou dans le cloud.

Gestion par les administrateurs Git dans les projets Tuleap

L’installation du plugin Tuleap-GitLab est la seule action qui nécessite un administrateur de site Tuleap. Tout le reste est entre les mains des administrateurs Git du projet Tuleap.

Créez des dépôts GitLab dans les projets Tuleap

C’est le fondement même de l’intégration Tuleap-GitLab. L’administrateur Git crée un dépôt GitLab sur Tuleap. Ce référentiel fait référence au projet GitLab sur lequel travaille l’équipe de développement. Les référentiels GitLab intégrés apparaîtront comme tous les référentiels git normaux, seulement nous avons ajouté une petite icône 🦊 pour les distinguer.

Une traçabilité de bout en bout avec l’intégration Tuleap-GitLab

Quel que soit l’endroit où le code est stocké et revu, la promesse de Tuleap est de garder une trace de ce qui est fait, quand et pour quoi. En d’autres termes, Tuleap fournit une traçabilité de bout en bout des exigences au code et du code aux exigences. Cela peut être obligatoire à des fins de réglementation (par exemple, pour l’ISO et la CEI utilisées dans le développement de dispositifs cyber-physiques), le dépannage, la gestion de l’historique et des connaissances, etc.

Avec l’intégration Tuleap-GitLab, bénéficiez d’une traçabilité de bout en bout même en dehors de Tuleap.

Utilisez les références croisées

Vous pouvez mentionner un ID d’artefact Tuleap dans un message de validation ou une demande de fusion de GitLab. L’ID d’artefact Tuleap (problème) ajoute une référence avec des détails et un lien vers l’activité dans GitLab.

La traçabilité ne concerne pas seulement les références : il s’agit de relier des informations pour comprendre pourquoi quelque chose a été fait. Dans le contexte du développement logiciel, ce qui se passe en production représente ce que chaque développeur a personnellement compris des exigences. C’est pourquoi les développeurs sont encouragés à référencer l’artefact Tuleap qui correspond au commit effectué. Selon le contexte, il peut s’agir d’une Tâche, d’une User Story ou d’un Besoin selon la méthodologie de votre équipe.

Les développeurs créent le lien entre le code et l’artefact en ajoutant un TULEAP-XYZ dans leurs messages de validation (où XYZ est l’ID d’artefact de l’exigence). Ces messages de commit seront analysés par Tuleap qui :

  • créer sur Tuleap une référence vers le commit
  • ajouter sur GitLab un commentaire sur le commit avec un lien vers l’artefact

NOTE

Référencer une tâche est un élément indispensable, mais chronophage, contre-productive : on oblige les développeurs à créer une relation 1-1 entre leur validation et les tâches à bord. C’est souvent très ennuyeux pour les développeurs et n’aide pas beaucoup pour la traçabilité car cela dilue les informations. La traçabilité doit se faire au plus près de l’expression du besoin (donc un objet de haut niveau comme une User Story).

Lien entre GitLab et un artefact Tuleap

Un commit GitLab lié à un artefact Tuleap

GitLab Merge Requests

La plupart de l’utilisation de GitLab tourne autour des Merge Requests (MR). Si vous ne connaissez pas beaucoup GitLab, les Merge Requests sont l’équivalent des Pull Requests de GitHub. Bien entendu, ici aussi, vous bénéficiez d’une traçabilité complète.

Un cas d’utilisation typique est d’avoir une User Story définie sur Tuleap avec des tâches de développement sur le tableau des tâches Tuleap. Ensuite, sur GitLab, le développement se déroule avec soit :

  • Une approche de branche de fonctionnalité, puis la demande de fusion correspondra à peu près à la user story. À ce stade, on s’attend à ce que le développeur intègre une référence à la user story dans son MR (comme « TULEAP-45678 Détection des couleurs des chiots »)
  • Ou une approche plus fine où chaque tâche de développement conduit à une RM. Là encore, le développeur pourra référencer la tâche dans le MR (une tâche un MR). Ils peuvent également décider de référencer l’histoire elle-même en ajoutant la référence dans la description MR « Part of TULEAP-45678 »

Dans les deux cas, en parcourant les artefacts Tuleap, n’importe qui pourra plonger ses mains profondément dans le code grâce à la référence à la Merge Request. Et comme Tuleap ajoute un commentaire avec un lien vers l’artefact dans la section des commentaires MR, les personnes qui regardent le MR pourront se connecter avec les spécifications, les tests, etc.

Aller plus loin