Intégrer Jira à Vélocité de changement DevOps - Classique
Connectez votre instance Jira Server ou Jira Cloud pour détecter, configurer et importer des projets et des éléments de travail tels que des stories, des épopées et des fonctionnalités.
Avant de commencer
Effectuez les tâches indiquées dans Premiers pas avec Vélocité de changement DevOps.
Rôle requis : sn_devops.admin ou sn_devops.tool_owner
Procédure
-
Connectez-vous à votre instance Jira Server ou Jira Cloud.
- Accédez à la DevOps > Outils > Créer nouveau (hérité).
-
Saisissez les détails de la connexion à votre instance Jira.
Jira Server - Dans le champ Nom de l'outil, saisissez un nom pour l'outil.
- Dans le champ Intégration d'outils, recherchez et sélectionnez Jira.
- 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.
-
Jira Cloud - Dans le champ Nom de l'outil, saisissez un nom pour l'outil.
- Dans le champ Intégration d'outils, recherchez et sélectionnez Jira Cloud.
- Dans le champ URL de l'outil, saisissez l'URL de votre instance Jira Cloud.
- Dans le champ Type d'informations d'identification, sélectionnez Authentification de base ou OAuth 2.0.
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
Prérequis :Dans le champ Informations d'identification de l'outil, sélectionnez un enregistrement d'informations d'identification existant de l'outil OAuth 2.0.- Obtain the value of Cloud ID
- Créer un enregistrement d'informations d'identification pour Jira Cloud
Remarque :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.
Pour obtenir la liste de toutes les autorisations requises sur les informations d'identification pour la connexion à Jira, reportez-vous à la section relative aux autorisations Jira dans Autorisations requises pour les outils DevOps.
- Facultatif :
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.
- Sélectionnez Soumettre.
L'outil est automatiquement connecté à l'aide d'un alias de connexion et d'une connexion HTTP (informations d'identification Authentification de base).
-
Si vous souhaitez contrôler l'accès à l'outil, ajoutez les groupes qui doivent y avoir accès dans le champ Maintenu par de l'onglet Accès.
Les tâches que les utilisateurs des groupes peuvent effectuer dépendent des rôles qui leur sont affectés.
Rôle Description 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 Peut afficher l'outil. Remarque :seuls les groupes contenant des utilisateurs disposant de rôles DevOps peuvent être sélectionnés dans le champ Maintenu par.Si vous choisissez de restreindre 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 Détecter pour détecter tous les projets existants dans Jira.
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.
-
Sélectionnez Configurer pour configurer les webhooks.
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.
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.Remarque :si vous ne disposez pas des privilèges d'administrateur pour Jira afin d'autoriser la configuration automatique de l'URL de webhook, demandez à votre administrateur Jira de la configurer pour vous. Cette action nécessite de créer et de configurer manuellement l'URL du webhook dans votre instance d'outil. Une fois le webhook configuré dans l'outil, sélectionnez Entrer en mode de configuration manuelle pour vous connecter à Jira manuellement, puis quittez le mode de configuration manuelle. -
Sélectionnez le lien connexe Importer pour importer des données historiques à partir de projets Jira.
Les éléments de travail importés sont ajoutés aux listes connexes correspondantes.
Remarque :si la clé d'un projet est mise à jour dans Jira, les noms d'objets mis à jour ne sont pas reflétés dans Vélocité de changement DevOps. Ce n'est que lorsque l'objet est mis à jour dans Jira que le nouveau nom est appliqué dans Vélocité de changement DevOps.