--- sourceDocument: Gestion des services IT Xanadu sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/it-service-management Release : - xanadu ft:locale : - fr-FR ft:publication_title : - Gestion des services IT Xanadu ft:clusterId : - itsm bundleId : - itsm workflow : - Technology --- # Utiliser un pipeline déclaratif ou scripté dans DevOps # Utiliser un pipeline déclaratif ou scripté dans DevOps {#ariaid-title1} * Rversion finale: Xanadu * * Mis à jour 1 août 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 minutes de lecture Lorsque vous utilisez un fichier Jenkins, les étapes sont créées, mappées et associées aux tâches d'orchestration automatiquement et non manuellement. Jenkinsfile est un fichier texte qui contient la définition d'un Jenkins pipeline et qui est archivé dans le contrôle de source. Chaque étape de niveau racine configurée dans le fichier Jenkins est détectée en tant que tâche d'orchestration distincte dans DevOps laquelle elle est mappée à une étape individuelle. Remarque : Le champ Suivre du pipeline doit être défini sur Vrai dans DevOps pour recevoir des notifications de tâches de Jenkins. Toutes les configurations Jenkins actives reçoivent des notifications de tâche lorsque ce champ est défini sur Vrai. ## DevOps Commandes Jenkinsfile {#dev-ops-scripted-pipeline__section_ccb_2yn_r3b} * snDevOpsChange(ignoreErrors :{true/false},changeRequestDetails :{setCloseCode :{true/false},attributes :}) Where ignoreErrors spécifie le paramètre permettant d'empêcher l'échec de la tâche en cas d'erreur (vrai/faux) Où changeRequestDetails spécifie le code de [fermeture et les champs de demande de changement](https://servicenow-prod.fluidtopics.net/IBugYBis~6dfhVeoU16Rww "Configurez la façon dont les champs Informations sur la fermeture, État du changement et Demande de changement sont mis à jour à partir d’un pipeline dans l’étape de changement du pipeline.") à partir du pipeline Active le contrôle des changements pour chaque étape de niveau racine mappée à une DevOps étape. * artefact snDevOpsArtifact Enregistre les artefacts lors de la configuration [Artefacts et packages](https://servicenow-prod.fluidtopics.net/zVo1XG8IqC1VN3qceF4Hlg "Les artefacts et les packages permettent Changements de vélocité DevOps de suivre les activités de développement et de test sur un large éventail de modèles de déploiement et de mise en production. Cette fonctionnalité garantit que l’activité du pipeline stockée dans le DevOps modèle de données peut être récupérée et appliquée lorsque les artefacts sont créés et publiés à différents moments ou dans différents pipelines.")d'. * snDevOpsPackage Crée un package pour les artefacts lors de la configuration [Artefacts et packages](https://servicenow-prod.fluidtopics.net/zVo1XG8IqC1VN3qceF4Hlg "Les artefacts et les packages permettent Changements de vélocité DevOps de suivre les activités de développement et de test sur un large éventail de modèles de déploiement et de mise en production. Cette fonctionnalité garantit que l’activité du pipeline stockée dans le DevOps modèle de données peut être récupérée et appliquée lorsque les artefacts sont créés et publiés à différents moments ou dans différents pipelines.")de . * snDevOpsGetChangeNumber Récupère le numéro de demande de changement dans un pipeline Jenkins en fonction des détails d'un changement spécifique. * snDevOpsUpdateChangeInfo (en anglais seulement) Met à jour les détails de la demande de changement associée à un pipeline Jenkins. * snDevOpsSecurityResult Configure les analyses de sécurité à n'importe quelle étape du pipeline et les détails de l'analyse sont récupérés à partir de l'étape correspondante vers la vélocité de changement DevOps. {#dev-ops-scripted-pipeline__ul_kbx_py3_r3b} Vous pouvez spécifier la Jenkins configuration du serveur au cours de l'une de ces étapes en transmettant l'attribut configurationName dans votre pipeline. Si le nom de la configuration n'est spécifié dans aucune étape, la configuration par défaut sera utilisée dans cette étape. Le passage d'un nom de configuration incorrect entraînera l'échec de l'étape, sauf si l'option Ignorer les erreurs DevOps ServiceNow est sélectionnée lors de la configuration du module d'extension Jenkins . Remarque : Le mappage d'étapes n'est pris en charge que pour les étapes au niveau racine, et non pour les étapes imbriquées ou parallèles. ## Jenkins Générateur d'extraits pour DevOps {#dev-ops-scripted-pipeline__section_vcx_kgw_f5b} Vous pouvez utiliser l'utilitaire Générateur d'extraits Jenkins pour générer un code de modèle pour les tâches d'orchestration des pipelines scriptés. Vous pouvez utiliser l'utilitaire de génération d'extraits pour créer un modèle pour les tâches d'orchestration suivantes. * SnDevOpsArtifact * Changement snDevOpsChange * Package SnDevOpsPackage * snDevOpsGetChangeNumber * snDevOpsUpdateChangeInfo (en anglais seulement) * snDevOpsSecurityResult {#dev-ops-scripted-pipeline__ul_i1g_fjw_f5b}Pour générer un extrait d'étape, accédez à la syntaxe du pipeline à partir d'un pipeline configuré, sélectionnez l'étape dans la liste Exemple d'étape , puis mettez à jour les valeurs des différentes variables de l'étape. Sélectionnez l'option Ignorer l'erreur pour empêcher 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 un pipeline. Exemple de script de pipeline pour la tâche SnDevOpsChange : snDevOpsChange changeCreationTimeOut: 3600, changeRequestDetails: '{ "attributes": { "short_description": "Test description", "priority": "1", "start_date": "2021-02-05 08:00:00", "end_date": "2022-04-05 08:00:00", "justification": "test justification", "description": "test description", "cab_required": true, "comments": "This update for work notes is from jenkins file", "work_notes": "test work notes", "assignment_group": "a715cd759f2002002920bde8132e7018" }, "setCloseCode": false, "autoCloseChange": true }', changeStepTimeOut: 18000, configurationName: 'Jenkins1', pollingInterval: 60 ## Prise en charge en parallèle et en sous-étape {#dev-ops-scripted-pipeline__section_yyr_gvy_jjb} Lorsqu'une étape (ou un ensemble d'étapes parallèles) est imbriquée dans une étape de pipeline, les règles suivantes s'appliquent : * Toute action de l'étape imbriquée est traitée dans le cadre de l'étape de niveau racine parent * Une seule demande de changement est créée (au niveau racine parent), même si plusieurs étapes imbriquées sous l'étape racine parent déclenchent un changement * Les tâches d'orchestration créées sont toujours associées à l'étape de niveau racine parent (et non à l'étape imbriquée) {#dev-ops-scripted-pipeline__ul_yb1_5xy_jjb} ## Sous-étape {#dev-ops-scripted-pipeline__example_vxg_yty_2bc} Dans cet exemple de sous-étape, si une demande de changement est créée à partir de la sous-étape (déployer PROD), les détails de l'étape de niveau racine parente (déployer) sont utilisés dans la demande de changement, et les tâches d'orchestration sont également associées à l'étape de niveau racine parente (déployer). stage("deploy") { stages{ stage('deploy UAT') { when{ branch 'dev' } stage('deploy PROD') { when { branch 'master' } steps{ snDevOpsChange() } } } ## Étape parallèle {#dev-ops-scripted-pipeline__example_wxg_yty_2bc} Dans cet exemple d'étape parallèle, si une demande de changement est créée à partir d'une sous-étape (test UAT 1 et/ou test de code statique UAT), seule la première demande de changement est créée (à l'aide des détails de l'étape de niveau racine parent, test UAT), que les deux sous-étapes (test UAT 1 et test de code statique UAT) soient déclenchées ou non. Il n'y a aucune indication de quelle étape parallèle a généré le changement, et les tâches d'orchestration sont associées à l'étape de niveau racine parent (test UAT). stage('UAT test') { parallel { stage('UAT test-1') { steps { snDevOpsChange() // 'UAT test-1' tasks } post { success { // post success tasks. E.g.: junit '**/target/surefire-reports/*.xml' } } } stage('UAT static code test') { steps { snDevOpsChange() // 'UAT static code test' tasks } } } }