État de la demande de changement ServiceNow DevOps dans les journaux de pipeline Jenkins

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 4 minutes de lecture
  • Vous pouvez utiliser l’utilitaire Jenkins Snippet Generator pour configurer comment et quand l’état du changement et les conditions de politique correspondantes doivent être affichés dans les journaux des tâches de pipeline Jenkins. Cela permet aux développeurs d’afficher l’état du changement dans les journaux de console du pipeline lui-même.

    Pour générer un extrait d’étape, accédez à la syntaxe du pipeline à partir d’un pipeline configuré, sélectionnez l’étape SnDevOpsChange dans la liste d’exemples d’étapes et mettez à jour les valeurs des variables d’état du changement dans l’étape. Sélectionnez l’option Ignorer l’erreur pour éviter l’échec de la tâche en cas d’erreur. Sélectionnez Générer un script de pipeline pour créer un extrait. Vous pouvez copier et coller l’extrait dans le pipeline pour commencer à recevoir les notifications d’état de changement. Mettez à jour les variables suivantes à l’étape SnDevOpsChange pour recevoir des notifications d’état de changement :
    • Intervalle d’interrogation : spécifie la fréquence (en secondes) à laquelle Jenkins interroge ServiceNow pour connaître l’état du changement et met à jour les journaux de la console avec cet état. L’état du changement n’est mis à jour dans les journaux de la console que lorsque les champs Transitions d’état du changement, Mises à jour du groupe d’affectation, Mises à jour de l’approbation, Date de début/fin planifiée ou Détails du changement (le cas échéant) sont mis à jour.
      Remarque :
      Si aucune valeur n’est saisie dans le champ, la vérification de l’intervalle d’interrogation n’est pas exécutée pour mettre à jour l’état du changement dans les journaux de la console.
    • Délai de création du changement : spécifie la valeur du délai de création du changement en secondes. Lors du délai d’expiration, Jenkins vérifie l’état de la création du changement dans ServiceNow. Si le changement n’a pas été créé, le pipeline est repris ou abandonné en fonction de l’indicateur d’échec Abandonner lors de la création du changement. Par défaut, le pipeline est abandonné lorsque le délai d’expiration est spécifié et que le marqueur d’échec Abandonner en cas de création de changement est sélectionné.
      Remarque :
      Si aucune valeur n’est saisie dans le champ, la vérification du délai d’expiration de création de changement n’est pas exécutée pour mettre à jour le pipeline.
    • Abandonner en cas d’échec de la création du changement : abandonnez ou reprenez le pipeline si le changement n’est pas créé avant l’expiration du délai de création du changement.
      • Sélectionné : Abandonner
      • Effacé : Reprendre
    • Délai d’expiration de l’étape de changement : spécifie la valeur du délai d’expiration de l’étape de changement en secondes. Lors du délai d’expiration, Jenkins vérifie l’état de l’étape de changement dans ServiceNow. Si l’étape de changement est toujours en cours, le pipeline est repris ou abandonné en fonction du marqueur Abandonner le délai d’expiration de l’étape de changement . Par défaut, le pipeline est abandonné lorsque le délai d’expiration est spécifié et le marqueur Abandonner lors du délai d’expiration de l’étape de changement est sélectionné.
      Remarque :
      Si aucune valeur n’est saisie dans le champ, la vérification du délai d’expiration de l’étape de changement n’est pas exécutée pour mettre à jour le pipeline.
    • Abandonner lors du délai d’expiration de l’étape de changement : abandonnez ou reprenez le pipeline si l’étape de changement est toujours en cours pendant le délai d’expiration de l’étape de changement.
      • Sélectionné : Abandonner
      • Effacé : Reprendre

    Vous pouvez accéder aux journaux de la console dans votre pipeline pour afficher l’état d’une demande de changement lorsqu’une demande de changement est créée ou lorsque l’état de la demande de changement est mis à jour. Les conditions de politique associées à l’état de la demande de changement seront également évaluées et affichées dans les journaux. Par exemple, si la politique d’automatisation avancée de la demande de changement DevOps est activée, les conditions de la politique seront évaluées et la décision correspondante (approbation automatique/rejet automatique/approbation manuelle) s’affichera dans les journaux.

    Les détails suivants de la demande de changement s’affichent :
    • Numéro
    • Détails
    • statut
    • sys_id
    • type
    • risk
    • Priorité
    • changeState
    • plannedStartDate
    • Date de fin planifiée
    • changeRequestURL

    Journaux d’état des changements dans la console de pipeline Jenkins

    Les journaux des conditions de politique s’afficheront pour les flux de changement du système de base comme suit :
    • Politique de changement de modèle DevOps : seuls les journaux sont affichés lors de la création du changement et lorsque l’état du changement est mis à jour.
    • Politique d’automatisation minimale de demande de changement DevOps : les journaux ainsi que les décisions de changement et les conditions de politique correspondant à la décision de changement seront affichés.
    • Politique d’automatisation avancée de demande de changement DevOps : les journaux ainsi que les décisions de changement et les conditions de politique correspondant à la décision de changement seront affichés.
    Les entrées de politique de changement et les conditions de décision sont stockées dans la table Décisions [sys_decision_question]. Les journaux s’affichent si les champs et les opérateurs suivants sont utilisés comme entrée pour les conditions de politique :
    Champs
    • code_coverage
    • commits_without_work_item
    • integration_tests_failed
    • load_tests_failed
    • regression_tests_failed
    • num_of_outages_in_last_7_days
    • num_of_current_outages
    • num_of_open_incidents
    • total_num_of_commits
    • tests_passing_percent
    • risk
    • code_security
    • validations
    Opérateurs
    • <=
    • >=
    • !=
    • =
    • <
    • >
    • ISNOTEMPTY
    • ISEMPTY
    • ENTRE
    • RIEN
    • NSAMEAS
    • SAMEAS
    • GT_FIELD
    • LT_FIELD
    Remarque :
    Si un champ est modifié dans une politique de changement autre que les champs du système de base, ces champs doivent être ajoutés manuellement au flux pour que les conditions de la politique soient évaluées.

    Si une demande de changement n’est pas créée en raison d’un problème, le motif et l’état de l’échec sont également consignés dans la console.