Intégrer Jira à Vélocité de changement DevOps - Espace de travail
Connectez-vous à votre instance Jira Server ou Jira Cloud à partir de l'espace de travail de changement DevOps pour détecter les plans disponibles et enregistrer des webhooks pour suivre les projets, les stories, les fonctionnalités et les épopées.
Avant de commencer
Effectuez les tâches spécifiées dans la rubrique Premiers pas avec Vélocité de changement DevOps.
Rôle requis : sn_devops.admin ou sn_devops.tool_owner
Procédure
-
Accédez à la et utilisez l’une des options suivantes pour ouvrir le playbook à intégrer Jira.
Option Étapes Page d'accueil - Sélectionnez Connecter un outil.
- Dans le modal Se connecter à un outil, sélectionnez Jira dans la catégorie Plan.
Module Applications - Sélectionnez Applications (
) dans la barre de navigation principale. - Sélectionnez une application existante ou créez-en une. Pour créer une application, consultez Créer une application - Espace de travail.
- Dans le volet Actions recommandées, sélectionnez la carte Connecter un outil.
- Dans le modal Se connecter à un outil, sélectionnez Jira dans la catégorie Plan.
Module Outils - Sélectionnez Outils (
) dans la barre de navigation principale. - Dans la liste Aptitude, sélectionnez Planification.
- Sélectionnez Connecter un outil.
- Dans le modal Se connecter à un outil, sélectionnez Jira.
Important :si vous souhaitez détecter et suivre des objets d'outil tels que des plans lors de la connexion à l'outil, vous devez connecter votre outil à partir du module Application. -
Connectez-vous à votre instance Jira Server ou Jira Cloud.
Jira Server - Dans la liste Plateforme, sélectionnez Serveur Jira.
- Dans le champ Nom de l'outil, saisissez un nom pour l'outil.
Ce nom permet d'identifier votre instance Jira dans la liste des outils connectés à Vélocité de changement DevOps.
Jira Cloud - Dans la liste Plateforme, sélectionnez Cloud Jira.
- Dans le champ Nom de l'outil, saisissez un nom pour l'outil.
Ce nom permet d'identifier votre instance Jira dans la liste des outils connectés à Vélocité de changement DevOps.
-
Terminez la procédure de connexion à votre outil Jira à l'aide du playbook.
-
Saisissez les détails de la connexion.
Jira Server - Saisissez l'URL de votre instance Jira Server.
- Dans la liste Type d'informations d'identification, sélectionnez le type d'authentification que vous souhaitez utiliser pour vous connecter à votre serveur Jira.
-
Authentification de base
- Saisissez votre nom d'utilisateur Jira Server.Remarque :le compte d'utilisateur Jira que vous utilisez ici doit disposer des autorisations d'administrateur Jira.
- Saisissez le mot de passe ou le jeton d'accès pour accéder à cette instance.
- Saisissez votre nom d'utilisateur Jira Server.
- Clé API
Saisissez le jeton d'API pour accéder à l'instance.
-
- Si votre instance Jira est liée à un Serveur MID, sélectionnez l'option Serveur MID et saisissez les détails correspondants.
Pour plus d'informations sur le serveur MID, consultez Sélection de Serveur MID.
Jira Cloud - Saisissez l'URL de votre instance Jira Cloud.Remarque :si vous sélectionnez le type d'informations d'identification OAuth 2.0 avec 3LO à l'étape suivante, vous devez saisir l'URL de votre instance Jira au format suivant :
Pour en savoir plus sur l'obtention de la valeur de l'ID cloud, consultez Obtain the value of Cloud ID.https://api.atlassian.com/ex/jira/<Cloud-ID> - Sélectionnez le type d'informations d'identification Authentification de base ou OAuth 2.0 avec 3LO.
Authentification de base
- Saisissez votre nom d'utilisateur Jira Cloud.Remarque :le compte d'utilisateur Jira que vous utilisez ici doit disposer des autorisations d'administrateur Jira.
- Saisissez le mot de passe ou le jeton d'accès pour accéder à cette instance.
OAuth 2.0 avec 3LO
Prérequis :Sélectionnez un enregistrement d'informations d'identification OAuth 2.0 existant dans le champ Informations d'identification ou sélectionnez Create OAuth 2.0 credential record (Créer un enregistrement d'informations d'identification OAuth 2.0) pour créer un enregistrement. Pour obtenir des instructions sur la création d'un enregistrement d'informations d'identification, consultez Créer un enregistrement d'informations d'identification pour Jira Cloud.- Créer un enregistrement d'informations d'identification pour Jira Cloud
Remarque :- L'option de création d'un enregistrement OAuth 2.0 n'est disponible que si vous disposez du rôle administrateur de connexion et d'authentification OAuth.
- Seuls les enregistrements qui ne sont pas utilisés ni configurés pour Jira Cloud peuvent être sélectionnés comme enregistrements d'informations d'identification existants.
- Saisissez votre nom d'utilisateur Jira Cloud.
- Si votre instance Jira est liée à un Serveur MID, sélectionnez l'option Serveur MID et saisissez les détails correspondants.
Pour plus d'informations sur le serveur MID, consultez Sélection de Serveur MID.
-
Des vérifications d'autorisation sont exécutées sur les informations d'identification que vous avez saisies.
Les autorisations requises et les autorisations disponibles s'affichent. Si vous souhaitez saisir des informations d'identification disposant de meilleures autorisations, sélectionnez Saisir à nouveau les informations d'identification. Pour obtenir des informations détaillées sur toutes les autorisations requises, consultez la section relative aux autorisations Jira dans Autorisations requises pour les outils DevOps.
Vous pouvez continuer avec la connexion de l'outil même si vous ne disposez pas de toutes les autorisations requises.
-
Saisissez les détails de la connexion.
-
Spécifiez l'accès à l'outil.
- Si vous souhaitez contrôler l'accès à l'outil, ajoutez les groupes qui doivent y avoir accès dans le champ Maintenu par.Les tâches que ces utilisateurs des groupes peuvent effectuer dépendent du rôle qui leur est affecté.
- Rôle Propriétaire de l'outil DevOps : peut afficher et modifier l'outil.
- Rôle Propriétaire de l'application DevOps : peut afficher l'outil, associer, détecter et importer des données historiques et modifier les étapes du pipeline (le cas échéant) des objets de l'outil (tels que les plans, les référentiels et les pipelines).
- Rôle Administrateur DevOps : peut modifier tous les outils.
- Autres rôles DevOps : peuvent afficher l'outil.
Remarque :Si vous ne sélectionnez pas de groupe et ignorez cette étape, tous les utilisateurs disposant du rôle Propriétaire de l'outil DevOps seront en mesure de modifier l'outil. - Si vous choisissez de contrôler l'accès à l'outil, l'option Tous les propriétaires d'applications peuvent visualiser et associer des objets d'outil aux applications peut être sélectionnée.
Cette option permet à tous les utilisateurs disposant du rôle Propriétaire de l'application DevOps d'accéder à l'outil. Si cette option est sélectionnée, ils seront en mesure d'afficher, d'associer, de détecter et d'importer des données historiques et pourront également modifier les étapes du pipeline (le cas échéant) des objets de l'outil.
- Sélectionnez Affecter.
- Si vous souhaitez contrôler l'accès à l'outil, ajoutez les groupes qui doivent y avoir accès dans le champ Maintenu par.
-
Pour envoyer des données en temps réel entre DevOps et votre instance Jira, sélectionnez Configurer.
Cette action effectue les opérations suivantes :
- Elle enregistre un webhook entre vos instances Jira et ServiceNow et permet le transfert de données en temps réel entre les deux.
- si vous avez connecté votre outil Jira à l'aide d'une authentification basée sur OAuth 2.0, les webhooks sont créés pour l'application d'intégration OAuth 2.0 dans Jira lorsque vous effectuez une configuration automatique, tandis que si vous vous êtes connecté à l'aide de l'authentification de base, les webhooks sont créés pour tous vos projets dans Jira. Si vous choisissez de configurer manuellement les webhooks pour un outil Jira créé à l'aide d'une authentification basée sur OAuth 2.0, un webhook en double peut être créé.
Tous les projets Jira détectés sont répertoriés en tant que plans.
Si vous n'effectuez pas la configuration maintenant, vous pouvez activer l'interrogation nocturne ultérieurement pour extraire les données de tous les plans suivis en définissant la propriété système Enable Polling sur Oui.
Pour configurer manuellement des webhooks, sélectionnez Configurer manuellement. Consultez Configurer manuellement des webhooks dans Jira pour plus d'informations.
Important :- Si vous vous connectez à partir de la page d'accueil ou du module Outils, la connexion est terminée et vous êtes redirigé vers la page Résumé.
- Si vous vous connectez à partir du module Applications, les plans disponibles dans votre instance Jira sont détectés. Vous pouvez en suivre et en importer des données historiques.
-
Sélectionnez les plans à suivre.
Sélectionnez les plans dont vous souhaitez suivre les mises à jour et que vous voulez associer à l'application.
Une fois l'intégration de l'outil terminée, seuls les éléments de travail de ces plans sélectionnés sont importés automatiquement.
Sélectionnez Suivant.
Si vous souhaitez importer des données de plan, sélectionnez la plage de dates, puis Soumettre.
Vous pouvez importer jusqu'à 90 jours de données.
-
Dans la page Résumé, sélectionnez Afficher l'enregistrement de l'outil pour examiner les détails de l'instance connectée et des plans détectés correspondants.
Résultats
Vous avez intégré avec succès votre outil Jira à Vélocité de changement DevOps.
Que faire ensuite
Sur la page d'enregistrement de l'outil, vous pouvez :
- Consulter les détails et l'état de l'outil.
- Détecter les plans et configurer les webhooks.Remarque :
- Par défaut, les projets sont détectés dans un ensemble de 50 pour Jira Cloud. 50 représente la limite de pagination maximale prise en charge par Jira. Si vous souhaitez réduire cette valeur, vous devez modifier la constante correspondante dans le script DevOpsCommonConstants.
- Les données de projet et de version détectées ne sont ni mises à jour ni suivies en temps réel.
- Affectez des groupes pour contrôler l'accès à l'outil à l'aide du champ Maintenu par.
- Vérifiez les autorisations des informations d'identification et mettez à jour les informations d'identification de l'outil. Pour en savoir plus, consultez Vérifier les autorisations et mettre à jour les informations d'identification des outils - Espace de travail.
- Dans l'onglet Plans, sélectionnez un plan pour en afficher les détails, tels que les éléments de travail importés, les fonctionnalités, etc.
- Pour importer des données historiques à partir des plans, associez ceux-ci à une application et importez les données. Pour plus d'informations, consultez Associer des objets d'outil à des applications - Espace de travail.