Intégrer Jenkins à Changements de vélocité DevOps — Espace de travail
Connectez-vous à votre Jenkins instance à l’aide du playbook de l’espace de travail de changement DevOps pour détecter les pipelines.
Avant de commencer
Effectuez les tâches spécifiées dans la Premiers pas avec Changements de vélocité DevOps rubrique.
Installez et activez le module d’extension ServiceNow DevOps pour Jenkins. Si vous l’avez déjà installée, effectuez la mise à jour vers la dernière version. Pour obtenir des instructions, consultez configure-jenkins-plugin.html.
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 champ À Onboard Jenkins.
Vous pouvez connecter un outil à partir d’une application si vous savez également quels pipelines spécifiques doivent être associés et suivis sous cette application pour rationaliser la configuration. Cela vous permettra également d’associer et d’importer facilement des données à partir de Jenkins .
Option Étapes Page d'accueil - Sélectionnez Connecter un outil.
- Dans le modal Connecter à un outil, sélectionnez l’outil dans la catégorie appropriée. Par exemple, si vous souhaitez vous connecter en Jenkins tant qu’outil d’orchestration, sélectionnez-le Jenkins dans la catégorie Orchestration .
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 Connecter à un outil, sélectionnez l’outil dans la catégorie appropriée. Par exemple, si vous souhaitez vous connecter en Jenkins tant qu’outil d’orchestration, sélectionnez-le Jenkins dans la catégorie Orchestration .
Module d’outils - Sélectionnez Outils (
dans la navigation primaire. - Dans la liste Aptitude, sélectionnez la catégorie appropriée. Par exemple, si vous souhaitez vous connecter en tant qu’outil d’orchestration Jenkins , sélectionnez la catégorie Orchestration .
- Sélectionnez Connecter un outil.
- Dans le modal Se connecter à un outil, sélectionnez Jenkins.
Important :Si vous souhaitez détecter et suivre des objets d’outil tels que des pipelines lors de la connexion à l’outil, vous devez connecter votre outil à partir du module Application. -
Dans le champ Nom de l’outil , saisissez un nom pour l’outil.
-
Sélectionnez Connexion.
-
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 en savoir plus sur toutes les autorisations requises, reportez-vous à la section Jenkins Autorisations 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.
-
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 .
-
Installez le module d’extension ServiceNow DevOps pour Jenkins.
Pour plus d’informations sur l’extension, reportez-vous à la section configure-jenkins-plugin.html.
-
Sélectionnez Configurer pour configurer automatiquement ServiceNow DevOps Configuration dans votre Jenkins instance.
Important :
-
Vous devez d’abord installer et activer le module d’extension ServiceNow DevOps pour Jenkins. Si vous l’avez déjà installée, effectuez la mise à jour vers la dernière version. Pour obtenir des instructions, consultez configure-jenkins-plugin.html.
- Pour configurer automatiquement les webhooks, Jenkins l’accès administrateur est requis.
- Si vous choisissez de configurer automatiquement cet outil, la configuration existante pour ServiceNow DevOps dans Jenkins sera remplacée.
- Vous pouvez ajouter un total de dix configurations ServiceNow.
Figure 1. Configure automatiquement la configuration de ServiceNow DevOps dans Jenkins Pour configurer manuellement les webhooks dans Jenkins, reportez-vous à la section Configurer manuellement les webhooks pour Jenkins.
Vous pouvez également choisir d’activer l’interrogation nocturne pour récupérer les données de tous les pipelines suivis en sélectionnant l’option de propriété Activer l’interrogation dans le module Administration . Consultez Propriétés du Changements de vélocité DevOps.
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 pipelines disponibles dans votre instance sont détectés. Vous pouvez en suivre et en importer des données historiques.
-
-
Sélectionnez les pipelines que vous souhaitez suivre à partir de l’activité Playbook Sélectionner des pipelines .
Pour chaque pipeline sélectionné, toutes les étapes sont importées pour la dernière exécution réussie.
- Facultatif :
Dans l’activité Affecter des services aux étapes du pipeline, spécifiez le type d’étape et le service pour chaque étape du pipeline.
La réalisation de cette étape dans le cadre de l’intégration de l’outil permet aux Analyses DevOps tableaux de bord d’afficher immédiatement des données plus significatives.
-
Sur la page Résumé , sélectionnez Afficher l’enregistrement de l’outilpour examiner les détails de l’outil connecté Jenkins .
Remarque :Si les informations d’identification de votre outil ont changé, vous devez les mettre à jour dans votre ServiceNow instance. Pour plus d'informations, consultez Mettre à jour les informations d’identification d’outils tiers dans Changements de vélocité DevOps.
Résultats
Vous avez intégré avec succès votre Jenkins outil à Changements de vélocité DevOps.