Configurer le module d'extension Jenkins

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 4 minutes de lecture

    • Configurez Jenkins pour envoyer des notifications en temps réel pour les exécutions de pipeline à Vélocité de changement DevOps.

    Avant de commencer

    Rôle requis : administrateur Jenkins

    Procédure

    1. Installez le module d'extension ServiceNow DevOps à partir de Jenkins Marketplace en accédant à Manage Jenkins (Gérer Jenkins) > Configuration système > Modules d'extension dans votre instance Jenkins.
    2. Recherchez le module d'extension ServiceNow DevOps et sélectionnez-le, puis sélectionnez Installer.

    Configurer manuellement des webhooks pour Jenkins

    Configurez des webhooks dans Jenkins pour envoyer des notifications de synchronisation à l'application Vélocité de changement DevOps.

    Avant de commencer

    Rôle requis : sn_devops.admin ou sn_devops.tool_owner dans Vélocité de changement DevOps, administrateur Jenkins

    Pourquoi et quand exécuter cette tâche

    Vous pouvez ajouter un total de dix configurations ServiceNow DevOps. Par exemple, vous pouvez configurer des connexions Jenkins pour vos instances de développement, de test, de production, etc.

    Si vous êtes un client qui effectue une mise à niveau, vous devez télécharger et installer le dernier module d'extension Jenkins pour activer plusieurs configurations ServiceNow. Après l'installation, votre configuration existante est conservée et devient la configuration par défaut.

    Dans la section Configuration de ServiceNow DevOps de Jenkins, les valeurs du champ Nom et de la combinaison des champs URL de l'instance et ID de l'outil d'orchestration doivent être uniques.

    Si vous choisissez de configurer automatiquement un outil à partir de ServiceNow, la configuration existante de ServiceNow DevOps est remplacée dans Jenkins.

    Si l'application DevOps Config est installée, vous pouvez uniquement configurer Jenkins manuellement.

    Procédure

    1. Dans Vélocité de changement DevOps, sélectionnez Configurer manuellement lors de la configuration de l'instance de l'outil pour envoyer des données.
      Configurez automatiquement des webhooks.
    2. Sélectionnez Copier dans le champ approprié pour copier la valeur dans le presse-papiers.

      L'étiquette du champ devient Copié, mais vous pouvez copier plusieurs fois.

      Configurez des webhooks manuellement.
    3. Dans Jenkins, accédez à Gérer Jenkins > Configuration système > Gérer les modules d’extension > Configurer le système.
    4. Dans la section Configuration de ServiceNow DevOps, sélectionnez Ajouter.
      Remarque :
      vous pouvez ajouter plusieurs connexions en sélectionnant Ajouter pour chaque nouvelle configuration.
    5. Configurez le module d'extension en remplissant les champs.

      Lorsqu'il est activé, Jenkins commence à envoyer des événements à DevOps en tant qu'événements entrants.

      Remarque :
      les valeurs sont sensibles à la casse.

      Champs à configurer dans Jenkins.

      Champ Description
      Actif Sélectionnez cette option pour activer la connexion. Par défaut, cette option est sélectionnée lorsque vous sélectionnez Ajouter pour une nouvelle connexion.
      Remarque :
      toutes les connexions pour lesquelles l'option Actif est activée envoient des notifications webhook pour l'exécution de votre pipeline. Cependant, pour l'étape de changement, seule la connexion spécifiée est prise en compte.
      Valeur par défaut Sélectionnez cette option pour faire de la connexion la connexion par défaut lorsque le nom de la connexion n'est pas transmis dans une étape existante d'un pipeline.
      Remarque :
      si vous ne sélectionnez pas cette option lorsqu'une seule connexion est disponible, une erreur est générée.
      Nom Nom unique de la connexion.
      Remarque :
      la valeur du champ Nom est générée automatiquement lorsque vous configurez automatiquement une connexion à partir de ServiceNow.
      URL de l'instance

      Saisissez l'URL de votre instance ServiceNow que vous avez copiée à l'étape 2. Par exemple, https://<votre-instance>.service-now.com.
      ID de l'outil d'orchestration

      Élément sys_id de l'outil d'orchestration que vous avez copié à l'étape 2.

      Vous pouvez également copier cette valeur à partir du champ URL Webhook (valeur toolid) ou l'obtenir directement à l'aide de la commande Copier sys_id sur l'enregistrement de l'outil d'orchestration.

      Remarque :
      la combinaison des valeurs des champs ID de l'outil d'orchestration et URL de l'instance doit être unique pour chaque connexion.
      ID de l'outil d'artefact

      Élément sys_id de l'outil d'artefact.
      Informations d'identification

      Sélectionnez les informations d'identification d'authentification de base que vous souhaitez utiliser pour vous connecter à Jenkins.

      1. Pour ajouter des informations d'identification, sélectionnez Ajouter.
      2. Dans le champ Nom d'utilisateur, saisissez vos détails Utilisateur d'intégration DevOps. Par défaut, devops.integration.user.
      3. Dans le champ Mot de passe, saisissez votre mot de passe Utilisateur d'intégration DevOps.
      Secret Credentials (Informations d'identification du secret)

      Sélectionnez le jeton secret que vous avez copié à l'étape 2. Vous pouvez également procéder comme suit pour obtenir le jeton secret à partir de l'enregistrement de l'outil.

      1. Copiez le jeton secret de votre outil Jenkins dans Changement DevOps.
        • Espace de travail : accédez à l'enregistrement de l'outil, sélectionnez Configurer et copiez le jeton secret.
        • Interface utilisateur classique : accédez à l'enregistrement de l'outil et sélectionnez Copier le jeton.
      2. Pour ajouter des jetons, sélectionnez Ajouter.
      3. Dans la liste Genre, sélectionnez Secret text (Texte secret).
      4. Dans le champ Secret, saisissez le jeton secret généré lors de la création de la connexion de l'outil Jenkins dans DevOps.
      5. Dans le champ ID, saisissez un nom pour le jeton.
      Niveau de journal Niveau des messages de journal que vous souhaitez stocker dans les journaux Jenkins/l'enregistreur de journaux ServiceNow.
      Sélectionnez l'une des options suivantes :
      • héritage
      • arrêt
      • severe
      • avertissement
      • info
      • config
      • fine (fin)
      • finer (plus fin)
      • finest (le plus fin)
      • tous

      Pour plus d'informations sur les niveaux de journal et les enregistreurs de journaux, consultez Niveaux de journaux et enregistreurs de journaux Jenkins.
      Forcer la vérification du suivi

      Cochez la case pour effectuer un appel d'API REST (POST) vers Jenkins pour chaque exécution de pipeline afin de déterminer si le pipeline est suivi ou non.

      Décochez la case pour stocker les détails dans le fichier snPipelineInfo.json et arrêter d'effectuer des appels d'API pour chaque exécution de pipeline.

      Remarque :
      lorsqu'un pipeline est suivi, toutes les configurations Jenkins actives reçoivent des notifications de tâche.
      Pull Request Pipeline Tracking Check (Vérification du suivi du pipeline de la demande d'extraction)

      Cochez cette case pour activer le suivi des pipelines de demandes d'extraction.

      Remarque :
      lorsqu'un pipeline est suivi, toutes les configurations Jenkins actives reçoivent des notifications de tâche.
    6. Sélectionnez Tester la connexion.
      Vérifiez que le message de réussite de la connexion s'affiche.
      • Si vous avez ajouté des informations d'identification d'authentification de base, en cas de connexion réussie, le message suivant s'affiche : Connection using 'Credentials' is successful (La connexion à l'aide des « Informations d'identification » a réussi).
      • Si vous avez ajouté le jeton secret, en cas de connexion réussie, le message suivant s'affiche : Connection using 'Secret Credentials' is successful (La connexion à l'aide des « Informations d'identification du secret » a réussi).
    7. Sélectionnez Appliquer pour appliquer les changements, puis Enregistrer.