jenkins2 pipeline插件的10个最佳实践

jenkins pipeline的10个最佳实践。

文章来自：http://www.ciandcd.com
文中的代码来自可以从github下载： https://github.com/ciandcd

翻译自：https://www.cloudbees.com/blog/top-10-best-practices-jenkins-pipeline-plugin

1. 使用最新的jenkins pipeline插件Jenkins Pipeline suite of plugins， 而不使用旧的类似功能插件，例如不使用旧的build pipeline plugin 或者旧的buildflow plugin。

新的pipeline插件是完全不同于旧的插件，新的pipeline job不同于旧的freestyle job，新的pipeline job可以不受jenkins master重启的影响，可以暂停重启。 新的pipeline job还可以实现更复杂的持续发布流程。

更多pipeline的学习，可以参考 https://jenkins.io/solutions/pipeline/。

2.  通过groovy脚本实现pipeline

使用groovy实现的pipeline流程，可以将对应的groovy脚本存储在文件Jenkinsfile， 且实现与源代码一起的版本控制。

Jenkinsfile与源代码一起版本控制，使得整个pipeline流程和源代码一起可重现。 通过Jenkinsfile实现的pipeline job，可以更容易地支持多个分支multi-branch, 更容易地支持组织和团队（GitHub organiztion and BitBucket Team）里的多个项目。

最好在groovy脚本Jenkinsfile的第一行增加#!groovy​， 使得各种ide工具或web page能够支持groovy的语法高亮。

3. 尽可能地在stage里实现所有的任务

所有pipeline里非配置的任务最好在stage块里实现。通过stage使得pipeline里所有的任务被组织为多个stage，每个stage都是一组相关的任务。

例如：

stage 'build'

//build

stage 'test'

//test

pipeline view 插件使得 pipeline的stage的view和monitor更加的清楚。

4. 所有资源消耗的操作都应该放到node上执行

默认地，Jenkinsfile里的脚本在jenkins master上执行，如果资源消耗的操作都在master上执行的话将影响jenkins master的运行。 所以任何资源消耗的操作都应该放到node中被分布到agent上执行，例如从git server clone代码，java代码的编译等都应该在node中执行。

stage 'build'
node{
    checkout scm
    sh 'mvn clean install'
}

5. 尽可能地使用parallel来使得任务并行地执行

将任务并行后，使得整个job的流程更够更快地完成，开发人员能够更早地得到结果。

parallel 'shifting':{
    //everything
}, 'left':{
    //I can
}

对于unit的并行执行，可以查看插件Parallel Test Executor plugin，更多详细介绍查看Parallel Test Execution on the CloudBees Blog。

6. 并行的任务运行在不同的node上

对于并行的任务使用不同的node，使得并行的任务不相互影响，能够实现真正的并行执行。

parallel 'integration-tests':{
    node('mvn-3.3'){ ... }
}, 'functional-tests':{
    node('selenium'){ ... }
}

7. 不要在node里使用input

input 能够暂停pipeline的执行等待用户的approve（自动化或手动），通常地approve需要一些时间等待用户相应。 如果在node里使用input将使得node本身和workspace被lock， 不能够被别的job使用。

所以一般在node外面使用input。

stage 'deployment'
input 'Do you approve deployment?'
node{
    //deploy the things
}

8. inputs应该封装在timeout中。

pipeline可以很容易地使用timeout来对step设定timeout时间。对于input我们也最好使用timeout。

timeout(time:5, unit:'DAYS') {
    input message:'Approve deployment?', submitter: 'it-ops'
}

9. 应该使用withEnv来修改环境变量

不建议使用env来修改全局的环境变量，这样后面的groovy脚本也将被影响。

一般使用withEnv来修改环境变量，变量的修改只在withEnv的块内起作用。

withEnv(["PATH+MAVEN=${tool 'm3'}/bin"]) {
    sh "mvn clean verify"
}

10.尽量使用stash来实现stage/node间共享文件，不要使用archive

在stash被引入pipeline DSL前，一般使用archive来实现node或stage间文件的共享。 在stash引入后，最好使用stash/unstash来实现node/stage间文件的共享。例如在不同的node/stage间共享源代码。

archive用来实现更长时间的文件存储。

stash excludes: 'target/', name: 'source'
unstash 'source'