Modéliser un Jenkins pipeline dans DevOps

Modélisez un Jenkins pipeline en mappant le pipeline à une application et en mappant DevOps les étapes du pipeline aux Jenkins étapes.

Avant de commencer

Le Jenkins module d’extension est ServiceNow DevOps fourni pour activer l’accélération du changement afin que votre outil d’orchestration puisse communiquer et ServiceNow DevOps contrôler certains aspects des exécutions de pipelines.

Installez le module d’extension à partir de Jenkins Marketplace. Accédez à Gérer Jenkins > Configuration système > les modules d’extension dans votre instance Jenkins. Recherchez le module d’extension ServiceNow DevOps et sélectionnez-le, puis sélectionnez Installer.

Rôle requis : sn_devops.admin

Pourquoi et quand exécuter cette tâche

Les pipelines scriptés (fichier Jenkins) et les travaux freestyle sont pris en charge.

Pour les pipelines Jenkinsfile, les étapes de pipeline sont créées, mappées et associées aux tâches d’orchestration automatiquement et non manuellement.

Procédure

1. Mapper votre pipeline à une application dans DevOps.
   1. Accédez à la DevOps > Applications et pipelines > Applications et ouvrez l’enregistrement d’application à associer au pipeline.
   2. Dans la liste connexe Pipelines, cliquez sur Modifier... pour sélectionner un pipeline à associer à l’application, ou cliquez sur Nouveau pour créer le pipeline.
      Pour un nouveau pipeline, renseignez le champ Pipeline Orchestration à l’aide du nom complet du projet, tel que spécifié dans Jenkins.

      Remarque :

      Lors de l’association d’un pipeline à une application, les étapes de pipeline sont également extraites pendant l’importation.
   3. Cliquez sur Envoyer.
2. Ouvrez à nouveau l’enregistrement de pipeline et cochez la case Suivre pour que les événements du pipeline soient reçus.
   Remarque :

   La case Suivre doit être cochée pour intégrer le pipeline à DevOps.
3. Créez DevOps automatiquement ou manuellement des étapes à mapper à chaque Jenkins étape du pipeline afin de créer une tâche d’orchestration.
   • Pour les pipelines déclaratifs ou scriptés, exécutez votre Jenkins pipeline pour créer et mapper automatiquement des étapes de pipeline dans DevOps.

     Les étapes de pipeline sont automatiquement créées, mappées et associées lorsqu’elles DevOps reçoivent des notifications d’étapes de votre pipeline Jenkins pendant l’exécution.

   • Pour les tâches Freestyle, créez et mappez manuellement chaque étape de pipeline à une Jenkins tâche de pipeline.

     Dans la liste connexe Étapes, cliquez sur Nouveau pour créer une DevOps étape pour chaque Jenkins étape du pipeline (champ Étape Orchestration )

     Remarque :

     La valeur du champ Étape d’orchestration de chaque étape est sensible à la casse et doit correspondre au nom d’origine de l’étape du pipeline correspondante Jenkins .

     Nom	Nom de l’étape du pipeline.
     Pipeline	Pipeline dans lequel l’étape est configurée.
     Type	Type d’étape du pipeline. Construire et tester Test Déployer Déployer et tester Manuel Déploiement produit
     Ordre	Ordre dans lequel les étapes sont exécutées. Remarque : L’ordre des étapes détermine l’ordre des cartes dans l’interface utilisateur du pipeline. L’ordre des cartes dans l’interface utilisateur du pipeline est défini par exécution de tâche.
     Étape d'orchestration	Jenkins Nom de l’étape du pipeline (sensible à la casse). Remarque : Pour l’association d’étapes avec Jenkins les étapes du pipeline, le champ Étape d’orchestration doit être configuré.
     Service d'entreprise	Service de configuration qui s’applique à l’étape.

     Une fois les tâches d’orchestration créées, associez chaque tâche d’orchestration de la liste connexe Tâches d’orchestration à une DevOps étape de pipeline.

4. Facultatif : Activer le contrôle des changements automatiquement ou manuellement en fonction du type de pipeline.
   • Pour les pipelines déclaratifs ou scriptés, si vous avez utilisé le script snDevOpsChange dans votre pipeline, exécutez votre Jenkins pipeline pour activer automatiquement le contrôle des changements. Vous pouvez également activer le contrôle des changements manuellement en suivant les étapes indiquées pour les tâches Freestyle.
   • Pour les tâches Freestyle, cochez la case Contrôle des changements dans une étape pour activer l’accélération du changement et les champs de configuration correspondants.
     Remarque :

     ServiceNow Change Management doit être installé pour accélérer le changement.

     Reçu de changement	Sélectionnez cette option pour activer la réception de changement pour l’étape afin que le pipeline ne s’interrompe pas lorsqu’une demande de changement est créée. Toutes les données du pipeline sont incluses dans le changement, mais l’approbation n’est pas requise pour que le pipeline se poursuive.
     Groupe d'approbation des changements	Groupe d’approbation de la demande de changement. Le groupe d’approbation des changements devient le groupe d’affectation dans la demande de DevOps changement. Remarque : Assurez-vous que le groupe sélectionné comporte des membres et un gestionnaire de groupe afin que le champ Approbateur ne soit pas vide.
     Type de changement	Type de demande de changement à créer. Normal (par défaut) Standard Urgence
     Modèle de changement	Modèle de changement pour la demande de changement. Pour plus d'informations, consultez DevOps Modèles de changement.
     Modèle Remarque : ce champ n’est affiché que lorsque le type de changement est Normal ou Urgent.	Liste des modèles à utiliser pour remplir automatiquement les champs des demandes de changement Normal ou Urgent. Sélectionnez un modèle ou créez-en un.
     Modèle de changement standard Remarque : ce champ n’est affiché que lorsque le type de changement est Standard.	Liste des modèles de changement standard à utiliser pour les demandes de changement standard. Remarque : Ce champ est obligatoire pour le type de changement Standard.
     Modifier les branches contrôlées	(Multibranche uniquement) Liste séparée par des virgules des branches sous contrôle des changements. Les caractères génériques sont pris en charge.

5. Accédez à la DevOps > Outils > Outils d'orchestration et dans l’enregistrement de l’outil Jenkins , copiez la valeur du champ DevOps URL Webhook .
   L’URL Webhook contient l’emplacement DevOps pour Jenkins envoyer des messages, y compris la sys_id de l’outil :

   https://<devops.integration.user> :<password>@<votre-instance>.service-now.com/api/sn_devops/v1/devops/tool/event/{sys_id de l’enregistrement}

Exemple

Figure 1. Application DevOps

Figure 2. DevOps pipeline

Figure 3. DevOps Étape du pipeline