Configuration de JIRA

DevOps Insights Le service prendra fin et sera interrompu le 31 août 2026. Le service Continuous Delivery sera interrompu dans les régions suivantes le 12 février 2027 : au-syd, ca-tor, us-east. Code Risk Analyzer sera également retiré du marché dans toutes les régions à cette date. Si ces fonctionnalités ne sont pas activement utilisées dans une région donnée, elles pourraient y être supprimées plus tôt et ne plus accepter de nouvelles instances. En savoir plus

JIRA est un outil qui assure le suivi des bogues et des problèmes liés à votre logiciel. L'intégration d'outils JIRA met à jour les problèmes de votre projet lorsque Jenkins ou Delivery Pipeline exécute un déploiement.

Pour que l'intégration d'outils JIRA puisse assurer le suivi des problèmes, vous devez utiliser JIRA Smart Commits dans vos messages de validation. Pour en savoir plus sur JIRA Smart Commits, consultez la section Utilisation de Smart Commits.

Configurez JIRA pour planifier, suivre et distribuer un code de qualité :

  1. Si vous configurez cette intégration d'outils lorsque vous créez la chaîne d'outils, à la section Intégrations configurables, cliquez sur JIRA.

  2. Si vous disposez d’une chaîne d’outils et que vous souhaitez y ajouter l’intégration de cet outil, dans la console d’ IBM Cloud, cliquez sur l’icône de menu (icône en forme de hamburger) > Automatisation de la plateforme > Chaînes d’outils. Sur la page Chaînes d'outils, cliquez sur la chaîne d'outils afin d'ouvrir sa page Vue d'ensemble.

    a. Cliquez sur Ajouter un outil.

    b. Dans la section Intégrations d'outils, cliquez sur JIRA.

  3. Si vous disposez d'un projet JIRA et que vous voulez vous y connecter, cliquez sur Existant pour le type JIRA :

    a. Saisissez la clé de projet JIRA pour le projet JIRA. Vous la trouverez dans l'URL du projet JIRA.

    b. Entrez l'URL de l'API de base de votre instance JIRA. Vous la trouverez dans l'en-tête de votre instance JIRA. Cliquez sur l'icône Administration, puis sur Système.

    c. Si vous vous connectez à une instance JIRA privée ou si vous souhaitez recevoir des informations de traçabilité de la part d'une instance JIRA publique, entrez votre nom d'utilisateur et votre mot de passe JIRA.

    d. Pour suivre le déploiement des modifications du code du projet en créant des étiquettes et des commentaires pour les problèmes référencés, cochez la case Suivi du déploiement des modifications du code. Prenez soin d'utiliser JIRA Smart Commit pour référencer les problèmes JIRA dans vos validations GitHub. Si vous ne sélectionnez pas cette option, l'intégration d'outils JIRA ignore les validations.

  4. Si vous souhaitez créer un projet JIRA, cliquez sur Nouveau pour le type JIRA :

    a. Saisissez une clé de projet JIRA à utiliser pour le nouveau projet. Cette clé est utilisée comme identificateur unique dans l'URL du projet.

    b. Saisissez un nom pour le projet JIRA.

    c. Entrez l'URL de l'API de base de votre instance JIRA. Vous la trouverez dans l'en-tête de votre instance JIRA. Cliquez sur l'icône Administration, puis sur Système.

    d. Saisissez le nom d'utilisateur du chef de projet JIRA que vous voulez utiliser pour ce projet. La personne que vous spécifiez comme chef de projet JIRA doit disposer de droits de chef de projet dans JIRA.

    e. Saisissez le nom d'utilisateur de l'administrateur pour cette instance de JIRA.

    f. Saisissez le mot de passe de l'administrateur pour cette instance de JIRA.

    . Pour suivre le déploiement des modifications du code du projet en créant des étiquettes et des commentaires pour les problèmes référencés, cochez la case Suivi du déploiement des modifications du code. Prenez soin d'utiliser JIRA Smart Commit pour référencer les problèmes JIRA dans vos validations GitHub. Si vous ne sélectionnez pas cette option, l'intégration d'outils JIRA ignore les validations.

  5. Cliquez sur Créer une intégration.

  6. Sur la page Présentation de la chaîne d'outils, sur la carte Outils tiers, cliquez sur JIRA pour afficher le tableau de bord du projet JIRA auquel vous vous êtes connecté.

Configuration de JIRA à l'aide de l'API

L'intégration de l'outil JIRA prend en charge les paramètres de configuration suivants que vous pouvez utiliser avec l 'API HTTP Toolchain et les SDK lorsque vous créez, lisez et mettez à jour des intégrations d'outils.

Vous devez spécifier la propriété tool_type_id dans le corps de la demande avec la valeur jira.

Paramètres d'intégration de l'outil JIRA
Paramètre Utilisation Type Argument Terraform Description
URL d'API requis, pouvant être mis à jour Chaîne URL d'API URL s de base sur l'API de votre instance JIRA.
enable_traceability facultatif, modifiable, Default: false Booléen enable_traceability Suivez le déploiement des modifications de code en créant des balises, des étiquettes et des commentaires sur les commits, les pull requests et les tickets référencés.
mot de passe facultatif, pouvant être mis à jour Mot de passe jeton_API Jeton d'API pour votre compte JIRA. Facultatif pour les projets publics. Vous pouvez utiliser une référence de secret de chaîne d'outils pour ce paramètre. Pour plus d'informations, voir Protection de vos données sensibles dans Continuous Delivery.
clé_projet requis, pouvant être mis à jour Chaîne clé_projet Clé de projet de votre projet JIRA.
username (nom d'utilisateur) facultatif, pouvant être mis à jour Chaîne username (nom d'utilisateur) Nom d'utilisateur de votre compte JIRA. Facultatif pour les projets publics.