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 gérer le code source et Tuleap pour la gestion agile et le suivi des artefacts. Grâce à une intégration avancée, il est simple d’utiliser les deux outils ensembles. Voici comment les utiliser simultanément.
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, ils peuvent être complémentaires selon vos besoins :
- Avec Tuleap : vous rassemblez une large audience autour d’un seul outil de gestion de projet à l’échelle de votre entreprise. Au delà des équipes de développement, Tuleap s’adresse à un public plus large, créant des équipes pluri-disciplinaires (RTE, PMO, BA, PO, QA, Dev…). Par ailleurs, Tuleap offre des fonctionnalités plus « haut niveau », comme la Gestion de Programme, un système de Suivi de tickets avancé, et d’autres complémentaire à la Gestion Agile d’Equipe comme la Gestion des Tests manuels et automatiques et la Gestion Documentaire.
- Avec GitLab : votre équipe de développement bénéficie des pipelines de CI/CD et d’une vue centralisée des repos Git qu’ils ont l’habitude d’avoir avec GitHub.
Quoiqu’il en soit, gardez en tête que chaque workspace Tuleap peut soit :
- gérer des dépôts Git et les Pull Requests directement dans Tuleap,
- utiliser l’intégration Tuleap-GitLab.
Les fonctionnalités de l’intégration Tuleap <-> 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.
- Référencez les artefacts Tuleap dans vos messages de commit Gitlab – ou dans les merge requests ou branche- et inversement. Une traçabilité dans les deux sens.
- Importez et synchronisez les Groupes GitLab dans Tuleap pour conserver une unité entre les outils
- Créez des branches ou pull requests Gitlab depuis Tuleap
- Clôturez automatiquement des artefacts Tuleap depuis un message de commit Gitlab
Comment fonctionne l’intégration Tuleap-Gitlab
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 : on oblige les développeurs à créer une relation 1-1 entre leur validation et les tâches. Il faut faciliter le travail des développeurs qui trouvent cela souvent fastidieux. La traçabilité doit donc se faire facilement, voire automatiquement et se rattacher au plus près de l’expression du besoin (donc un artefact 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 avec Tuleap, 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.