前言碎語
jenkins是一款流行的開源持續集成軟件，插件豐富，擴展靈活。2.0後推出pipeline流式構建，支持構建任務腳本化。本文主要旨在使用jenkins 的pipeline功能完成java maven項目的打包，上傳jar到目標服務器。pipeline推出時間不長，實際使用的不是很多，網上基本沒啥參考資料，官方的文檔很詳細，但不成本文所述體系。這篇博文是博主摸索半天后的成果，如有錯落，歡迎指出。
說明：本文環境默認包含組件：jenkins，maven，jdk
一，安裝pipeline支持插件
到配置中心插件管理搜索如下插件，安裝
Pipeline Maven Integration Plugin ：執行withMaven方法支持，用於構建maven項目工程,使用方式如下圖，詳細說明見：https://wiki.jenkins.io/display/JENKINS/Pipeline+Maven+Plugin
SSH Agent Plugin ：sshagent方法支持，用於上傳構建產物到目標服務器，使用詳情見：
https://wiki.jenkins.io/display/JENKINS/SSH+Agent+Plugin，這邊博主實操時有個大坑，後面說詳細說明
二，創建流式Item，如圖
三，編寫pipeline腳本
腳本分三個步驟塊，分別是git clone（下載源碼到本地），build（構建工程），deploy（上傳構建產物到目標主機），腳本如下：
node {
stage('git clone') { // for display purposes
checkout([$class: 'GitSCM', branches: [[name: '*/${branch}']], doGenerateSubmoduleConfigurations: false, extensions: [], submoduleCfg: [], userRemoteConfigs: [[credentialsId: 'xxxx-xxxx-xxxxx-xxxxxx', url: 'http://git.xx.xxx/xxx/xform-boot.git']]])
}
stage('Build') {
env.JAVA_HOME="${tool 'jdk1.8.0_92'}"
withMaven(
maven: 'M3',
mavenLocalRepo: '.repository') {
sh "mvn clean install -U -P${profile} -Dmaven.test.skip=true"
}
}
stage('deploy') {
sshagent(credentials: ['deploy_ssh_key']) {
sh 'ssh [email protected]'
sh 'echo hello'
sh 'scp producer/target/salesApp-1.0-RELEASES.jar [email protected]:/root/deploy/'
}
}
}
如上腳本需要配置兩個認證憑證，分別是git的credentialsId和sshagent的credentials，到配置管理credentials處添加，如圖
git的認證比較簡單，使用密碼用戶名驗證，直接選Username with password就好了，這裡還有個技巧，後面會講到。
sshagen測試下來只支持私鑰，需要選擇如下配置：
如圖，使用了From the Jenkins master ~./ssh,需要你到jenkins所在主機的.ssh目錄，通過命令”ssh-keygen -t rsa“生成公私鑰，生成時會詢問你是否使用密碼 加密，可以直接跳過，如果寫了密碼，那麼上圖中Passphrase需要寫上加密密碼，沒寫就留空。然後將id_rsa.pub中的內容拷貝到目標主機的/root/.ssh/authorized_keys文件中。上圖中的ID可以指定，不指定會生成一個唯一字符串如：
這個ID對應了pipeline腳本中的驗證ID，到此，我們準備工作都已經做完了。
添加運行參數
細心的你可能發現了腳本中有類似佔位符。這些的代碼，如${branch},${profile},其實就是pipeline的佔位符，這些參數控制了git從哪個分支拉代碼，maven構建的哪個環境的代碼，這些參數需要在構建任務中明確指定，用以區分是生產環境還是測試環境等，如圖
四，嘗試構建任務
到這裡我們的準備工作都已完成了，可以開啟構建任務測試了，這時博主走了一個好大的坑，無論認證憑證模塊怎麼配置，總是拋如下的異常：Host key verification failed.
這個異常非常明顯，pipeline流式構建前兩個步驟已經成功了，代碼拉下來並已經構建成功了。但是通過sshagent上傳到目標服務器時，認證失敗了。這個問題佔了我們摸索過程的一大半時間。最後還是感謝唐老大發現了問題。
異常原因：生產公私鑰使用的root用戶生產的，jenkins是使用jenkins用戶啟動的，所有jenkins沒有權限，
其實上面所有的步驟都沒問題。最終在嘗試了無數次的構建失敗後構建圖標終於綠了，構建產物成功上傳到目標主機
一次次的失敗：
成功的綠標
五，pipeline的一點技巧
流式項目Item創建好後，在左邊菜單最下面會有pipeline的語法菜單，點進去，會有如下頁面：
1.其中箭頭一所指的，就是前文提到的git添加認證的一個小技巧，這個是一個pipeline腳本生成器，選中git scm後會出來git相關的配置，按照提示添加後，點擊生成，就會生成以及配置組裝好的腳本。特別適合新手
2.箭頭而是步驟指南，這個裡面羅列了所有pipeline語法支持的一些DSL函數，如git，checkout，wthMaven等，並且詳細的描述了方法的具體使用細節，詳細 到每個參數的說明，如withMavene：
文末結語
pipeline的概念去年就聽說了，現在實際操作了一把，還是非常的震撼，通過在項目中新增jenkinsfile就可以解決構建問題，而且非常靈活，支持寫if等的邏輯判斷腳本來決定構建行為。經歷了無數次失敗後成功的成就感不言而喻，有興趣的都可以試試，徹底改變原先的構建模式。建議剛接觸pipeline的新手，多看看pipeline語法頁面的相關內容，對理解pipeline語法及書寫腳本有很大的幫助。其次就是去相關的插件wiki頁面多看看說明。國內的那些博客很多都是一筆帶過，看不出在生產上面應用的痕跡，不建議去參考。最後，有任何問題歡迎在下面留言，一起討論。
閱讀更多 小陳博主 的文章
