Règle d'automatisation Jira pour le merge d'une pull request
Ce guide détaille comment créer une règle d'automatisation Jira qui fait passer un ticket à l'état « Done » (Terminé) et avertit les parties prenantes par e-mail lorsqu'une pull request est mergée.
Durée
5 minutes de lecture.
Public
Vous êtes un utilisateur expérimenté de Jira Software et de GitLab.
PRÉREQUIS
Vous êtes déjà client GitLab. Obtenez l'intégration GitLab for Jira ici.
Si vous découvrez GitLab, lancez-vous ici.
Vous disposez d'un projet Jira actif avec l'app GitLab installée et configurée. Lancez-vous avec Jira ici.
Étape 1. Ajoutez une règle d'automatisation
Sur la page de votre projet Jira, cliquez sur le bouton Add automation (Ajouter une règle d'automatisation). Sélectionnez ensuite l'option Branch, commit or pull requests (Branche, commit ou pull requests).
Recherchez et sélectionnez l'action Pull request merged (Pull request mergée). Cette règle s'exécute lorsqu'une pull request est mergée dans GitLab.
Étape 2. Ajoutez un composant de condition JQL
Ensuite, ajoutez un composant de condition JQL à la règle. Recherchez et sélectionnez JQL condition (Condition JQL).
Configurez la condition JQL en écrivant une requête JQL et en l'enregistrant. La requête est « Input the query development[pullrequests].open = 0 ». Cliquez ensuite sur le bouton Save (Enregistrer). Cette requête permet de s'assurer que s'il existe d'autres pull requests ouvertes pour le ticket, le ticket ne passe pas à l'état « Done » (Terminé).
Étape 3. Ajoutez une action Transition issue (Changer l'état du ticket)
Nous allons maintenant faire passer le ticket à l'état « Done » (Terminé). Recherchez et sélectionnez l'action Transition issue (Changer l'état du ticket).
Configurez l'action Transition issue (Changer l'état du ticket) pour définir l'état du ticket sur DONE (TERMINÉ).
Étape 4. Ajoutez une action Send Email (Envoyer un e-mail)
Ensuite, ajoutez une action qui envoie un e-mail aux parties prenantes pour les informer que la pull request a été mergée. Recherchez et sélectionnez l'action Send Email (Envoyer un e-mail).
Nous allons maintenant configurer l'action Send Email (Envoyer un e-mail) pour qu'elle envoie à certaines adresses e-mail pertinentes des données de modèle renseignées à partir de la pull request. Les valeurs que nous avons utilisées dans le contenu de l'e-mail et entourées de parenthèses sont des valeurs intelligentes. La valeur intelligente {{pullRequest.title}} est utilisée pour renseigner le titre et {{pullRequest.url}} pour inclure l'URL de la pull request. En savoir plus sur les valeurs intelligentes. Lorsque vous avez configuré l'action Send Email (Envoyer un e-mail), cliquez sur le bouton Save (Enregistrer) pour continuer.
Entrez le nom de cette règle, puis cliquez sur le bouton Turn It on (Activer).
Le résumé final de la règle devrait ressembler à ceci :
Vous pouvez désormais déclencher cette règle en créant un ticket Jira et le désignant dans une pull request mergée. Consultez le journal d'audit pour examiner son comportement et diagnostiquer les erreurs éventuelles. Pour référence lors de la création d'autres règles, consultez des centaines d'autres règles dans notre bibliothèque de modèles d'automatisation.