Jira est un produit de suivi des problèmes populaire couramment utilisé pour faciliter le développement de logiciels agiles. Il prend en charge le contrôle de code source d’Atlassian, BitBucket, qui relie directement les problèmes aux commits, mais vous pouvez également activer le même support pour Gitlab.
Que fait l'intégration?
Fondamentalement, l'intégration Jira pour Gitlab vous permet de lier les problèmes Jira aux commits Git. Chaque fois que des modifications sont transmises à Gitlab, il vérifie si des problèmes Jira sont mentionnés dans le message de validation ou la description, et ajoute un commentaire au problème.
Il s’agit d’une fonctionnalité simple, mais cruciale pour relier les deux plates-formes. Supposons que vous donniez à un développeur un ensemble de problèmes sur lesquels travailler dans un sprint de code. Ce développeur crée un tas de commits et les pousse vers Gitlab chaque fois que les tâches sont terminées, en mentionnant des problèmes dans le processus. Lorsque le chef de projet passe par Jira, il sera en mesure de voir rapidement les commits associés pour tous les problèmes, car il y aura des liens vers chaque commit sur le problème.
Cela fonctionne également dans l'autre sens: à partir de Gitlab, vous pourrez voir rapidement quels problèmes un commit mentionne. Cela vous permet généralement d’économiser un clic, mais c’est une fonctionnalité intéressante à utiliser lorsque vous rencontrez de nombreux problèmes.
Avec l'intégration, vous pouvez également automatiser la fermeture des problèmes à partir des messages de validation. Si vous demandez aux développeurs de déplacer les problèmes de "En cours" à "En cours de révision", vous pouvez configurer Gitlab pour le faire chaque fois que quelqu'un écrit " Résout le PROJET-1 »Dans un message de validation.
Les mêmes fonctionnalités sont également prises en charge pour les demandes de fusion, utiles lorsque vous avez un développeur travaillant sur sa propre branche qui doit fusionner dans master.
Configuration de l'intégration Jira
L'intégration Jira est configurée par projet, alors rendez-vous sur la page de votre projet et cliquez sur «Paramètres»> «Intégrations»:
Tout d'abord, vous souhaiterez activer l'intégration en cochant «Actif». Vous pouvez également désactiver les déclencheurs de demande de validation et de fusion, mais vous les voulez probablement.
Ensuite, entrez votre URL Web Jira. Si vous utilisez la version cloud gérée de Jira (sur atlassian.net), vous insérerez votre companyname.atlassian.net URL. Si vous hébergez vous-même Jira, vous indiquez l'URL de votre instance, probablement quelque chose comme jira.companyname.com. Si vous hébergez vous-même Jira et que vous placez l'API sur un autre domaine, vous pouvez éventuellement le saisir ici.
Si vous utilisez la version cloud de Jira, vous souhaiterez insérer votre e-mail et un jeton API, qui vous pouvez obtenir à partir de cette page. Créez un nouveau jeton et collez-le dans la zone de Gitlab. Cela authentifiera Gitlab sur votre compte Atlassian. Si vous utilisez Jira auto-hébergé, vous voudrez simplement saisir votre nom d'utilisateur et votre mot de passe.
Dans tous les cas, vous souhaiterez probablement créer un compte de service afin que les messages apparaissent à partir de "Gitlab" plutôt que de votre compte utilisateur personnel. Si vous ne souhaitez pas payer pour un compte supplémentaire, votre compte personnel fonctionnera parfaitement.
Ensuite, vous devrez donner à Gitlab une liste d'identifiants de transition. Ceux-ci définissent les différentes étapes des problèmes, par exemple, «Todo», «En cours» et «Terminé». Il est étrange que Gitlab ne le configure pas automatiquement, mais vous pouvez en obtenir une liste à partir de l'API Jira en accédant à l'URL suivante dans votre navigateur:
https://yourcompany.atlassian.net/rest/api/2/issue/ISSUE-1/transitions
Notez que vous devrez remplacer «votre entreprise» par votre URL Jira réelle, et sous «ISSUE-1» pour un véritable ID de problème. Cela donnera
var x = `coller la réponse ici`
console.log (JSON.parse (x) .transitions.map ((d) => d.id) .join (','))
Ce qui renverra quelque chose comme 11, 21, 31 (valeur par défaut) que vous entrerez dans la zone ID de transition.
Utilisation de l'intégration Jira
L'utilisation de l'intégration Jira est assez simple. Il n'y a pas de cases à cocher ni de leviers à tirer, mentionnez simplement un ID de problème Jira n'importe où dans le sujet ou la description d'un commit, et Gitlab publiera automatiquement un commentaire sur le problème en renvoyant à la page de commit:
C'est bien et tout, mais être capable de fermer les problèmes des commits est encore mieux. Vous pouvez actuellement utiliser trois mots déclencheurs pour résoudre un problème:
- Résout le PROJET-1
- Ferme PROJECT-1
- Corrige PROJECT-1
Vous pouvez écrire ces éléments en ligne dans des messages de validation ou des descriptions:
Chacun d'entre eux fera la même chose: déplacez le problème associé vers le dernier ID de transition que vous avez spécifié dans la liste. Si vous ne souhaitez pas que les développeurs déplacent directement les problèmes vers "Terminé", vous pouvez configurer Gitlab pour qu'il envoie des validations vers "En cours de révision" en omettant les ID de transition pour les catégories indésirables.