如果您閱讀此博客文章，則很有可能正在尋找有關(guān)腳本化和聲明性管道之間的實(shí)際差異的信息，對(duì)嗎?那你找不到更好的地方了。我將向您展示這兩者之間的四個(gè)最實(shí)際的區(qū)別。和我待幾分鐘，享受旅程!
為什么要有兩種管道類型?
- 腳本化管道是Jenkins中作為代碼的管道的第一個(gè)實(shí)現(xiàn)。即使它使用底層的管道子系統(tǒng)，它還是或多或少地設(shè)計(jì)為使用Groovy構(gòu)建的通用DSL。這意味著它不具有固定的結(jié)構(gòu)，并且由您決定如何定義管道邏輯。
- 聲明性管道更自以為是，其結(jié)構(gòu)是明確定義的。可能看起來(lái)有些局限。
但實(shí)際上，您可以使用腳本化或聲明性管道來(lái)實(shí)現(xiàn)相同的目的。那么選擇哪一個(gè)呢?如果您問(wèn)我這個(gè)問(wèn)題，我會(huì)說(shuō)使用聲明性管道。以下內(nèi)容這就是為什么。
1.管道啟動(dòng)時(shí)的代碼驗(yàn)證
pipeline {
agent any
stages {
stage("Build") {
steps {
echo "Some code compilation here..."
}
}
stage("Test") {
steps {
echo "Some tests execution here..."
echo 1
}
}
}
}
如果我們嘗試運(yùn)行以下管道，則驗(yàn)證將很快使構(gòu)建失敗。該日志顯示只能與觸發(fā)String參數(shù)，所以我們得到這樣的錯(cuò)誤。
請(qǐng)注意，管道沒(méi)有執(zhí)行任何階段，只是失敗了。這可能為我們節(jié)省了很多時(shí)間-想象一下執(zhí)行Build階段幾分鐘，而只是獲取echo步驟希望得到的信息java.lang.String而不是java.lang.Integer。
現(xiàn)在，讓我們看一下與該示例等效的腳本管道。
node {
stage("Build") {
echo "Some code compilation here..."
}
stage("Test") {
echo "Some tests execution here..."
echo 1
}
}
該管道執(zhí)行相同的階段和相同的步驟。但是，有一個(gè)明顯的區(qū)別。讓我們執(zhí)行它，看看它產(chǎn)生什么結(jié)果。
它按預(yù)期失敗。但是這次是執(zhí)行Build階段，也是Test階段的第一步。如您所見(jiàn)，沒(méi)有驗(yàn)證管道代碼。在這種情況下，聲明式管道可以更好地處理此類用例。
2.從指定步驟重新開(kāi)始
聲明式管道具有的另一個(gè)很酷的功能是“從階段重新啟動(dòng)”。讓我們修復(fù)上一個(gè)示例中的管道，看看是否只能重新啟動(dòng)Test階段。
pipeline {
agent any
stages {
stage("Build") {
steps {
echo "Some code compilation here..."
}
}
stage("Test") {
steps {
echo "Some tests execution here..."
}
}
}
}
讓我們執(zhí)行它。
在這里您可以看到已選擇測(cè)試階段。在右側(cè)的步驟列表上方，有一個(gè)名為“重新啟動(dòng)測(cè)試”的選項(xiàng)。讓我們單擊它并查看結(jié)果。
如您所見(jiàn)，Jenkins跳過(guò)了Build階段(它使用了先前構(gòu)建中的工作空間)，并從Test階段開(kāi)始了下一個(gè)管道執(zhí)行。當(dāng)您執(zhí)行一些外部測(cè)試并且由于遠(yuǎn)程環(huán)境的某些問(wèn)題而導(dǎo)致測(cè)試失敗時(shí)，這可能會(huì)很有用。您可以使用測(cè)試環(huán)境解決問(wèn)題，然后重新運(yùn)行該階段，而無(wú)需重建所有工件。(在這種情況下，應(yīng)用程序的代碼未更改。)
現(xiàn)在，讓我們看一下腳本化管道示例。
node {
stage("Build") {
echo "Some code compilation here..."
}
stage("Test") {
echo "Some tests execution here..."
}
}
如您所見(jiàn)，沒(méi)有重新啟動(dòng)選項(xiàng)。聲明式管道與腳本式管道-2：0。
3.聲明式管道options塊
兩種管道類型都支持第三個(gè)功能，但是我認(rèn)為聲明性管道更好地處理了它。假設(shè)我們將以下功能添加到上一個(gè)管道中。
- 控制臺(tái)日志中的時(shí)間戳。
- ANSI顏色輸出。
- 在1分鐘的超時(shí)構(gòu)建階段，2分鐘超時(shí)的測(cè)試階段。
聲明式管道如下所示。
pipeline {
agent any
options {
timestamps()
ansiColor("xterm")
}
stages {
stage("Build") {
options {
timeout(time: 1, unit: "MINUTES")
}
steps {
sh 'printf "\\e[31mSome code compilation here...\\e[0m\\n"'
}
}
stage("Test") {
options {
timeout(time: 2, unit: "MINUTES")
}
steps {
sh 'printf "\\e[31mSome tests execution here...\\e[0m\\n"'
}
}
}
}
讓我們運(yùn)行它。
這是控制臺(tái)日志。
Started by user Szymon Stepniak
Running in Durability level: MAX_SURVIVABILITY
[Pipeline] Start of Pipeline
[Pipeline] node
Running on Jenkins in /home/wololock/.jenkins/workspace/pipeline-sandbox
[Pipeline] {
[Pipeline] timestamps
[Pipeline] {
[Pipeline] ansiColor
[Pipeline] {
[Pipeline] stage
[Pipeline] { (Build)
[Pipeline] timeout
15:10:04 Timeout set to expire in 1 min 0 sec
[Pipeline] {
[Pipeline] sh
15:10:04 + printf '\e[31mSome code compilation here...\e[0m\n'
15:10:04 Some code compilation here...
[Pipeline] }
[Pipeline] // timeout
[Pipeline] }
[Pipeline] // stage
[Pipeline] stage
[Pipeline] { (Test)
[Pipeline] timeout
15:10:04 Timeout set to expire in 2 min 0 sec
[Pipeline] {
[Pipeline] sh
15:10:05 + printf '\e[31mSome tests execution here...\e[0m\n'
15:10:05 Some tests execution here...
[Pipeline] }
[Pipeline] // timeout
[Pipeline] }
[Pipeline] // stage
[Pipeline] }
[Pipeline] // ansiColor
[Pipeline] }
[Pipeline] // timestamps
[Pipeline] }
[Pipeline] // node
[Pipeline] End of Pipeline
Finished: SUCCESS
在聲明性管道中，選項(xiàng)與管道腳本邏輯分開(kāi)。該腳本管道也支持timestamps，ansiColor和timeout選項(xiàng)，但它需要一個(gè)不同的代碼。這是使用腳本化管道表達(dá)的相同管道。
node {
timestamps {
ansiColor("xterm") {
stage("Build") {
timeout(time: 1, unit: "MINUTES") {
sh 'printf "\\e[31mSome code compilation here...\\e[0m\\n"'
}
}
stage("Test") {
timeout(time: 2, unit: "MINUTES") {
sh 'printf "\\e[31mSome tests execution here...\\e[0m\\n"'
}
}
}
}
}
我想你看到了問(wèn)題。在這里，我們僅使用timestamps和ansiColorJenkins插件。想象再添加一個(gè)或兩個(gè)插件。聲明式與腳本式，3：0。
4.用when塊跳過(guò)階段。
在此博客文章中我最后要提到的是when聲明性管道支持的塊。讓我們改進(jìn)前面的示例并添加以下條件：
- 僅在等于時(shí)執(zhí)行測(cè)試階段。env.FOO``bar
這是聲明性管道代碼的外觀。
pipeline {
agent any
options {
timestamps()
ansiColor("xterm")
}
stages {
stage("Build") {
options {
timeout(time: 1, unit: "MINUTES")
}
steps {
sh 'printf "\\e[31mSome code compilation here...\\e[0m\\n"'
}
}
stage("Test") {
when {
environment name: "FOO", value: "bar"
}
options {
timeout(time: 2, unit: "MINUTES")
}
steps {
sh 'printf "\\e[31mSome tests execution here...\\e[0m\\n"'
}
}
}
}
然后執(zhí)行它。
該測(cè)試如預(yù)期階段被跳過(guò)。現(xiàn)在，讓我們嘗試在腳本化管道示例中執(zhí)行相同的操作。
node {
timestamps {
ansiColor("xterm") {
stage("Build") {
timeout(time: 1, unit: "MINUTES") {
sh 'printf "\\e[31mSome code compilation here...\\e[0m\\n"'
}
}
if (env.FOO == "bar") {
stage("Test") {
timeout(time: 2, unit: "MINUTES") {
sh 'printf "\\e[31mSome tests execution here...\\e[0m\\n"'
}
}
}
}
}
}
如您所見(jiàn)，我們必須使用if-condition來(lái)檢查是否env.FOO等于bar，然后才添加Test階段。(不幸的是，這并不是真正的跳過(guò)。)讓我們運(yùn)行它，看看結(jié)果如何。
這是不同的結(jié)果。在腳本化管道用例中，甚至不會(huì)呈現(xiàn)“ 測(cè)試”階段。在我看來(lái)，這可能會(huì)帶來(lái)一些不必要的混亂，聲明性管道會(huì)更好地處理它。聲明式與腳本式，4：0。
結(jié)論
這是我在聲明性和腳本化Jenkins管道之間的四大區(qū)別。這些不是唯一的區(qū)別，我想您的列表可能看起來(lái)有些不同。你的選擇是什么?您更喜歡聲明性管道還是腳本化管道?
原文地址：https://mp.weixin.qq.com/s/W3ejhef-RfxINMjN8gzIzg
