本篇繼續學習Declarative Pipeline的相關指令，本篇學習三個指令，分別是觸發器（triggers），stage和tool。觸發器主要是方便周期控制自動化提交，stage是在stages{...}下的一個指令，我們平臺的大部分代碼都在stage內完成，tool主要就是為了三大工具（jdk, gradle,maven）提供環境變量服務的。

指令1：triggers

該triggers指令定義了Pipeline應重新觸發的自動化方式。對于與源代碼集成的Pipeline，如GitHub或BitBucket，triggers可能不需要基于webhook的集成可能已經存在。目前有三個可用的觸發器是cron和pollSCM 和 upstream。

這個triggers是觸發器的意思，所以這塊是設置什么條件下觸發pipeline代碼執行，以及觸發的頻率。看到這里，如果你學習過Jenkins UI功能部分，你應該記得有下面這個圖，用來控制輪詢頻率的，特別適合周期的自動化提交。

這篇介紹的觸發器知識點就和這個有關。先記住這個點，在一個pipeline{…}代碼中，只運行出現一次triggers{…},而且這個指令不是必須存在的。

cron

??? 接受一個cron風格的字符串來定義Pipeline應重新觸發的常規間隔，例如： triggers { cron('H 4/* 0 0 1-5') }

pollSCM

??? 接受一個cron風格的字符串來定義Jenkins應該檢查新的源更改的常規間隔。如果存在新的更改，則Pipeline將被重新觸發。例如：triggers { pollSCM('H 4/* 0 0 1-5') }

upstream

接受逗號分隔的作業字符串和閾值。 當字符串中的任何作業以最小閾值結束時，將重新觸發pipeline。例如：triggers { upstream(upstreamProjects: 'job1,job2', threshold: hudson.model.Result.SUCCESS) }

舉例一個可能利用scm的場景，如果一個公司做到了很好的代碼覆蓋測試，一般都會，如果監控到有人提交代碼，就會自動化觸發啟動相關的單元測試。這個場景就是適合在pipeline代碼里使用triggers指令，下面代碼舉例一個pollSCM的基本使用。

pipeline {agent anytriggers {pollSCM (‘H H(9-16)/2 * * 1-5)’)}stages {stage('Example') {steps {echo 'Hello World'}}} }

解釋下“H H(9-16)/2 * * 1-5)”的含義，這個你可以在上面截圖這個頁面點擊右側這個問號，出來具體含義。第一步，先根據空格，把字符串切割成5段。這5部分在下面這張圖有解釋。

所以，H H(9-16)/2 * * 1-5) 的含義就是：

第一部分“H” 表示hash，記住不是表示hour，是一個散列值，含義就是在一個小時之內，會執行一次，但是這次是一個散列值，而且不會并發執行。

第二部分“H(9-16)/2”，表示白天在早上9點到下午5點，每間隔2小時執行一次。

第三部分“*“，每天執行

第四部分“*“表示每月執行

第五部分“1-5“ 表示周一到周五執行

所以上面這個表達式“H H(9-16)/2 * * 1-5) “的含義就是，在每個月的周一到周五的白天，從早上9點到下午5點，每間隔兩個小時去觸發一次自動化構建。 這個就比較適合，我們每天上班，間隔兩個小時去跑一次單元自動化測試。間隔時間長短，取決服務器壓力和業務具體場景。

?

指令2：stage

該stage指令在該stages部分中，應包含步驟部分，可選agent部分或其他特定于階段的指令。實際上，Pipeline完成的所有實際工作都將包含在一個或多個stage指令中。

?

特點：stage一定是在stages{…}里面，一個pipeline{…}中至少有一個stages{…}和一個stage{…}.這里多說一句，一個stage{…}中至少有一個steps{…}。Stage{…}還有一個特點就是，里面有一個強制的字符串參數，這個字符串參數就是描述這個stage是干嘛的，這個字符串參數是不支持變量的，只能你自己取名一個描述字段。

代碼舉例：

pipeline {agent anystages {stage('Example') {steps {echo 'Hello World'}}} }

指令3：tool

定義自動安裝和放置工具的部分PATH。如果agent none指定，這將被忽略。

特點：

只支持定義maven jdk gradle三種工具的環境變量。

代碼舉例：

pipeline {agent anytools {jdk 'jdk8' }stages {stage('Example') {steps {sh 'java -version'}}} }

注意：工具名稱必須在Jenkins?管理Jenkins?→?全局工具配置中預配置。例如，上面代碼我寫了jdk，那么我必須在jenkins管理的全局工具配置中有jdk配置。

?

?

總結

以上是生活随笔為你收集整理的Jenkins高级篇之Pipeline语法篇-7-Declarative Pipeline指令：triggers/stage/tool的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。