Intégrer Jira à Changements de vélocité DevOps — Espace de travail
Connectez-vous à votre serveur ou Jira à votre Jira instance cloud à partir de l’espace de travail de changement DevOps pour découvrir 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 Premiers pas avec Changements de vélocité DevOps rubrique.
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 à embarquer 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 d’application - Sélectionnez Applications (
) dans la navigation primaire. - Sélectionnez une application existante ou créez-en une. Pour créer une application, reportez-vous à la section app-create-workspace.html.
- Dans le volet Actions recommandées, sélectionnez la fiche Connecter un outil .
- Dans le modal Se connecter à un outil, sélectionnez Jira dans la catégorie Plan .
Module d’outils - Sélectionnez Outils (
dans la navigation primaire. - Dans la liste Aptitude, sélectionnez Planification.
- Sélectionnez Connecter un outil.
- Sur 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 serveur ou Jira à votre Jira instance 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 Jira instance à partir de la liste des outils connectés à Changements de vélocité DevOps.
JiraCloud - Dans la liste Plateforme , sélectionnez Jira Cloud.
- Dans le champ Nom de l’outil , saisissez un nom pour l’outil.
Ce nom permet d’identifier votre Jira instance à partir de la liste des outils connectés à Changements de vélocité DevOps.
-
Terminez la connexion à votre Jira outil à l’aide du playbook.
-
Entrez les détails de la connexion.
Jira Server - Entrez l’URL de votre Jira instance de serveur.
- Dans la liste Type d’informations d’identification , sélectionnez le type d’authentification que vous souhaitez utiliser pour vous connecter à votre Jira serveur.
-
Authentification de base
- Entrez votre nom d’utilisateur de serveur Jira .Remarque :L’utilisateur Jira que vous utilisez ici doit disposer des autorisations Administrateur Jira .
- Entrez le mot de passe ou le jeton d’accès pour accéder à cette instance.
- Entrez votre nom d’utilisateur de serveur Jira .
- Clé API
Saisissez le jeton d’API pour accéder à l’instance.
-
- Si votre Jira instance est associée à un Serveur MID, sélectionnez l’option Serveur MID et entrez ses détails.
Pour plus d’informations sur le MID Server, reportez-vous à la section Sélection du MID Server
JiraCloud - Entrez l’URL de votre Jira instance Cloud.
- Entrez votre nom d’utilisateur dans le Jira cloud.Remarque :L’utilisateur Jira que vous utilisez ici doit disposer des autorisations Administrateur Jira .
- Entrez le mot de passe ou le jeton d’accès pour accéder à cette instance.
- Si votre Jira instance est associée à un Serveur MID, sélectionnez l’option Serveur MID et entrez ses détails.
Pour plus d’informations sur le MID Server, reportez-vous à la section Sélection du MID Server
-
Les contrôles d’autorisation sont exécutés 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 avec de meilleures autorisations, sélectionnez Saisir à nouveau les informations d’identification. Pour plus d’informations sur toutes les autorisations requises, consultez Autorisations Jira dans Autorisations requises pour DevOps les outils.
Vous pouvez choisir de continuer avec la connexion de l’outil même si vous ne disposez pas de toutes les autorisations requises.
-
Entrez les détails de la connexion.
-
Spécifiez l’accès pour l’outil.
- Si vous souhaitez contrôler l’accès à l’outil, ajoutez les groupes qui doivent avoir accès à l’outil dans le champ Géré par .Les tâches que ces utilisateurs peuvent effectuer dans les groupes dépendent du rôle qui leur est affecté.
- DevOps Rôle du propriétaire de l’outil : peut afficher et modifier l’outil.
- DevOps Rôle du propriétaire de l’application : permet d’afficher l’outil et peut associer, détecter, 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).
- DevOps Rôle d’administrateur : peut modifier tous les outils.
- Autres DevOps rôles : peut afficher l’outil.
Remarque :Si vous ne sélectionnez pas de groupe et ignorez cette étape, tous les utilisateurs ayant le rôle de 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 afficher et associer des objets d’outil aux applications devient disponible à la sélection.
Cette option permet à tous les utilisateurs ayant le rôle de DevOps propriétaire de l’application d’accéder à l’outil. Si cette option est sélectionnée, ils seront en mesure d’afficher, d’associer, de détecter, d’importer des données historiques et de 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 avoir accès à l’outil dans le champ Géré par .
-
Pour envoyer des données en temps réel entre DevOps et votre Jira instance, sélectionnez Configurer.
Cette action effectue les opérations suivantes :
- Enregistre un webhook entre vos Jira instances et ServiceNow et permet le transfert de données en temps réel entre les deux.
- Détecte tous les projets disponibles à partir de votre Jira instance.
Tous les projets détectés Jira sont répertoriés en tant que plans.
Si vous ne choisissez pas de configurer maintenant, vous pouvez activer ultérieurement l’interrogation nocturne pour extraire les données de tous les plans suivis en définissant la Enable Polling propriété système sur Oui.
Pour configurer manuellement, sélectionnez Configurer manuellement. Consultez config-webhooks-jira-manually.html 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 depuis le 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 pour lesquels vous souhaitez suivre les mises à jour et les 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.
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 les plans détectés à partir de celle-ci.
Résultats
Vous avez intégré avec succès votre Jira outil à Changements de vélocité DevOps.
Que faire ensuite
Sur la page d’enregistrement de l’outil, vous pouvez :
- Consultez 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 le cloud. 50 est 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 Géré 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 pour les outils : espace de travail.
- Dans l’onglet Plans , sélectionnez un plan pour afficher ses détails, tels que les éléments de travail importés, les fonctionnalités et autres.
- Pour importer des données historiques à partir des plans, associez les plans à une application et importez les données. Pour plus d'informations, consultez Associer des objets d’outil à des applications : espace de travail.