一、引言

jenkins pipeline语法的发展如此之快用日新月异来形容也不为过，而目前国内对jenkins pipeline关注的人还非常少，相关的文章更是稀少，唯一看到w3c有篇相关的估计是直接翻译软件翻的，读下来惨不忍睹。
没办法，语法详解这章我干脆把jenkins官网上的语法说明全部翻译了一遍，并更新了陈旧的内容（可怜了我大学四级的英语水平~），英语好的朋友也可以直接到官网阅读。

二、语法简介

Pipeline最基本的部分是“step”。基本上，step告诉Jenkins 要做什么，并且作为Declarative Pipeline和Scripted Pipeline语法的基本构建块。 
Pipeline支持两种语法：Declarative Pipeline（在Pipeline 2.5中引入，结构化方式）和Scripted Pipeline，两者都支持建立连续输送的Pipeline。
为与BlueOcean脚本编辑器兼容，通常建议使用Declarative Pipeline的方式进行编写,从jenkins社区的动向来看，很明显这种语法结构也会是未来的趋势。

三、Declarative Pipeline

Declarative Pipeline是Jenkins Pipeline 的一个相对较新的补充， 它在Pipeline子系统之上提出了一种更为简化和有意义的语法。
所有有效的Declarative Pipeline必须包含在一个pipeline块内，例如：
pipeline { /* insert Declarative Pipeline here */ }
Declarative Pipeline中的基本语句和表达式遵循与Groovy语法相同的规则 ，但有以下例外：
a.Pipeline的顶层必须是块，具体来说是：pipeline { }
b.没有分号作为语句分隔符。每个声明必须在自己的一行
c.块只能包含Sections, Directives, Steps或赋值语句。
d.属性引用语句被视为无参方法调用。所以例如，输入被视为input（）

1.Sections（章节）

Declarative Pipeline里的Sections通常包含一个或多个Directives或 Steps

agent

该agent部分指定整个Pipeline或特定阶段将在Jenkins环境中执行的位置，具体取决于该agent 部分的放置位置。该部分必须在pipeline块内的顶层定义 ，但stage级使用是可选的。

 

为了支持Pipeline可能拥有的各种用例，该agent部分支持几种不同类型的参数。这些参数可以应用于pipeline块的顶层，也可以应用在每个stage指令内。
参数
any
在任何可用的agent 上执行Pipeline或stage。例如：agent any
none
当在pipeline块的顶层使用none时，将不会为整个Pipeline运行分配全局agent ，每个stage部分将需要包含其自己的agent部分。
label
使用提供的label标签，在Jenkins环境中可用的代理上执行Pipeline或stage。例如：agent { label 'my-defined-label' }
node
agent { node { label 'labelName' } }，等同于 agent { label 'labelName' }，但node允许其他选项（如customWorkspace）。
docker
定义此参数时，执行Pipeline或stage时会动态供应一个docker节点去接受Docker-based的Pipelines。 docker还可以接受一个args，直接传递给docker run调用。例如：agent { docker 'maven:3-alpine' }或

  1. docker
  2. agent {
  3.     docker {
  4.         image 'maven:3-alpine'
  5.         label 'my-defined-label'
  6.         args  '-v /tmp:/tmp'
  7.     }
  8. }

dockerfile
使用从Dockerfile源存储库中包含的容器来构建执行Pipeline或stage 。为了使用此选项，Jenkinsfile必须从Multibranch Pipeline或“Pipeline from SCM"加载。
默认是在Dockerfile源库的根目录：agent { dockerfile true }。如果Dockerfile需在另一个目录中建立，请使用以下dir选项：agent { dockerfile { dir 'someSubDir' } }。您可以通过docker build ...使用additionalBuildArgs选项，如agent { dockerfile { additionalBuildArgs '--build-arg foo=bar' } }。
常用选项
这些是可以应用于两个或多个agent的选项。除非明确定义，否则不需要。
label
一个字符串。标记在哪里运行pipeline或stage
此选项适用于node，docker和dockerfile，并且 node是必需的。
customWorkspace
一个字符串。自定义运行的工作空间内。它可以是相对路径，在这种情况下，自定义工作区将位于节点上的工作空间根目录下，也可以是绝对路径。例如：

  1. customWorkspace
  2. agent {
  3.     node {
  4.         label 'my-defined-label'
  5.         customWorkspace '/some/other/path'
  6.     }
  7. }

reuseNode
一个布尔值，默认为false。如果为true，则在同一工作空间中。
此选项适用于docker和dockerfile，并且仅在 individual stage中使用agent才有效。
Example

  1. Jenkinsfile (Declarative Pipeline)
  2. pipeline {
  3.     //Execute all the steps defined in this Pipeline within a newly created container of the given name and tag (maven:3-alpine).
  4.     agent { docker 'maven:3-alpine' }
  5.     stages {
  6.         stage('Example Build') {
  7.             steps {
  8.                 sh 'mvn -B clean verify'
  9.             }
  10.         }
  11.     }
  12. }
  1. Stage-level agent section
  2. pipeline {
  3.     agent none
  4.     stages {
  5.         stage('Example Build') {
  6.             agent { docker 'maven:3-alpine' }
  7.             steps {
  8.                 echo 'Hello, Maven'
  9.                 sh 'mvn --version'
  10.             }
  11.         }
  12.         stage('Example Test') {
  13.             agent { docker 'openjdk:8-jre' }
  14.             steps {
  15.                 echo 'Hello, JDK'
  16.                 sh 'java -version'
  17.             }
  18.         }
  19.     }
  20. }

post

定义Pipeline或stage运行结束时的操作。post-condition块支持post部件：always，changed，failure，success，unstable，和aborted。这些块允许在Pipeline或stage运行结束时执行步骤，具体取决于Pipeline的状态。

 

conditions项：
always
运行，无论Pipeline运行的完成状态如何。
changed
只有当前Pipeline运行的状态与先前完成的Pipeline的状态不同时，才能运行。
failure
仅当当前Pipeline处于“失败”状态时才运行，通常在Web UI中用红色指示表示。
success
仅当当前Pipeline具有“成功”状态时才运行，通常在具有蓝色或绿色指示的Web UI中表示。
unstable
只有当前Pipeline具有“不稳定”状态，通常由测试失败，代码违例等引起，才能运行。通常在具有黄色指示的Web UI中表示。
aborted
只有当前Pipeline处于“中止”状态时，才会运行，通常是由于Pipeline被手动中止。通常在具有灰色指示的Web UI中表示。

Example

  1. post
  2. pipeline {
  3.     agent any
  4.     stages {
  5.         stage('Example') {
  6.             steps {
  7.                 echo 'Hello World'
  8.             }
  9.         }
  10.     }
  11.     post {
  12.         always {
  13.             echo 'I will always say Hello again!'
  14.         }
  15.     }
  16. }

stages

包含一个或多个stage的序列，Pipeline的大部分工作在此执行。建议stages至少包含至少一个stage指令，用于连接各个交付过程，如构建，测试和部署等。

 

steps

steps包含一个或多个在stage块中执行的step序列。

 

Example

  1. stages
  2. pipeline {
  3.     agent any
  4.     stages {
  5.         stage('Example') {
  6.             steps {
  7.                 echo 'Hello World'
  8.             }
  9.         }
  10.     }
  11. }

2.Directives （指令）

environment

environment指令指定一系列键值对，这些键值对将被定义为所有step或stage-specific step的环境变量，具体取决于environment指令在Pipeline中的位置。
该指令支持一种特殊的方法credentials()，可以通过其在Jenkins环境中的标识符来访问预定义的凭据。
对于类型为“Secret Text”的凭据，该 credentials()方法将确保指定的环境变量包含Secret Text内容；对于“标准用户名和密码”类型的凭证，指定的环境变量将被设置为username:password。

 

Example

  1. environment
  2. pipeline {
  3.     agent any
  4.     environment {
  5.         CC = 'clang'
  6.     }
  7.     stages {
  8.         stage('Example') {
  9.             environment {
  10.                 AN_ACCESS_KEY = credentials('my-prefined-secret-text')
  11.             }
  12.             steps {
  13.                 sh 'printenv'
  14.             }
  15.         }
  16.     }
  17. }

options

options指令允许在Pipeline本身内配置Pipeline专用选项。Pipeline本身提供了许多选项，例如buildDiscarder，但它们也可能由插件提供，例如 timestamps。

 

可用选项
buildDiscarder
pipeline保持构建的最大个数。例如：options { buildDiscarder(logRotator(numToKeepStr: '1')) }
disableConcurrentBuilds
不允许并行执行Pipeline,可用于防止同时访问共享资源等。例如：options { disableConcurrentBuilds() }
skipDefaultCheckout
默认跳过来自源代码控制的代码。例如：options { skipDefaultCheckout() }
skipStagesAfterUnstable
一旦构建状态进入了“Unstable”状态，就跳过此stage。例如：options { skipStagesAfterUnstable() }
timeout
设置Pipeline运行的超时时间。例如：options { timeout(time: 1, unit: 'HOURS') }
retry
失败后，重试整个Pipeline的次数。例如：options { retry(3) }
timestamps
预定义由Pipeline生成的所有控制台输出时间。例如：options { timestamps() }

Example

  1. options
  2. pipeline {
  3.     agent any
  4.     options {
  5.         timeout(time: 1, unit: 'HOURS')
  6.     }
  7.     stages {
  8.         stage('Example') {
  9.             steps {
  10.                 echo 'Hello World'
  11.             }
  12.         }
  13.     }
  14. }

parameters

parameters指令提供用户在触发Pipeline时的参数列表。这些参数值通过该params对象可用于Pipeline步骤，具体用法如下

 

可用参数
string
A parameter of a string type, for example: parameters { string(name: 'DEPLOY_ENV', defaultValue: 'staging', description: '') }
booleanParam
A boolean parameter, for example: parameters { booleanParam(name: 'DEBUG_BUILD', defaultValue: true, description: '') }
目前只支持[booleanParam, choice, credentials, file, text, password, run, string]这几种参数类型，其他高级参数化类型还需等待社区支持。
Example

  1. params
  2. pipeline {
  3.     agent any
  4.     parameters {
  5.         string(name: 'PERSON', defaultValue: 'Mr Jenkins', description: 'Who should I say hello to?')
  6.     }
  7.     stages {
  8.         stage('Example') {
  9.             steps {
  10.                 echo "Hello ${params.PERSON}"
  11.             }
  12.         }
  13.     }
  14. }

triggers

triggers指令定义了Pipeline自动化触发的方式。对于与源代码集成的Pipeline，如GitHub或BitBucket，triggers可能不需要基于webhook的集成也已经存在。目前只有两个可用的触发器：cron和pollSCM。

 

cron
接受一个cron风格的字符串来定义Pipeline触发的常规间隔，例如： triggers { cron('H 4/* 0 0 1-5') }
pollSCM
接受一个cron风格的字符串来定义Jenkins检查SCM源更改的常规间隔。如果存在新的更改，则Pipeline将被重新触发。例如：triggers { pollSCM('H 4/* 0 0 1-5') }

Example

  1. triggers
  2. pipeline {
  3.     agent any
  4.     triggers {
  5.         cron('H 4/* 0 0 1-5')
  6.     }
  7.     stages {
  8.         stage('Example') {
  9.             steps {
  10.                 echo 'Hello World'
  11.             }
  12.         }
  13.     }
  14. }

stage

stage指令在stages部分中，应包含stop部分，可选agent部分或其他特定于stage的指令。实际上，Pipeline完成的所有实际工作都将包含在一个或多个stage指令中。

 

Example

  1. stage
  2. pipeline {
  3.     agent any
  4.     stages {
  5.         stage('Example') {
  6.             steps {
  7.                 echo 'Hello World'
  8.             }
  9.         }
  10.     }
  11. }

tools

通过tools可自动安装工具，并放置环境变量到PATH。如果agent none，这将被忽略。

 

Supported Tools
maven
jdk
gradle

Example

  1. tools
  2. pipeline {
  3.     agent any
  4.     tools {
  5.         //工具名称必须在Jenkins 管理Jenkins → 全局工具配置中预配置。
  6.         maven 'apache-maven-3.0.1'
  7.     }
  8.     stages {
  9.         stage('Example') {
  10.             steps {
  11.                 sh 'mvn --version'
  12.             }
  13.         }
  14.     }
  15. }

when

when指令允许Pipeline根据给定的条件确定是否执行该阶段。该when指令必须至少包含一个条件。如果when指令包含多个条件，则所有子条件必须为stage执行返回true。这与子条件嵌套在一个allOf条件中相同（见下面的例子）。
更复杂的条件结构可使用嵌套条件建：not，allOf或anyOf。嵌套条件可以嵌套到任意深度。

 

内置条件
branch
当正在构建的分支与给出的分支模式匹配时执行，例如：when { branch 'master' }。请注意，这仅适用于多分支Pipeline。
environment
当指定的环境变量设置为给定值时执行，例如： when { environment name: 'DEPLOY_TO', value: 'production' }
expression
当指定的Groovy表达式求值为true时执行，例如： when { expression { return params.DEBUG_BUILD } }
not
当嵌套条件为false时执行。必须包含一个条件。例如：when { not { branch 'master' } }
allOf
当所有嵌套条件都为真时执行。必须至少包含一个条件。例如：when { allOf { branch 'master'; environment name: 'DEPLOY_TO', value: 'production' } }
anyOf
当至少一个嵌套条件为真时执行。必须至少包含一个条件。例如：when { anyOf { branch 'master'; branch 'staging' } }

Example

  1. when
  2. pipeline {
  3.     agent any
  4.     stages {
  5.         stage('Example Build') {
  6.             steps {
  7.                 echo 'Hello World'
  8.             }
  9.         }
  10.         stage('Example Deploy') {
  11.             when {
  12.                 allOf {
  13.                     branch 'production'
  14.                     environment name: 'DEPLOY_TO', value: 'production'
  15.                 }
  16.             }
  17.             steps {
  18.                 echo 'Deploying'
  19.             }
  20.         }
  21.     }
  22. }

3.Steps（步骤）

Declarative Pipeline可以使用 Pipeline Steps reference中的所有可用步骤 ，并附加以下仅在Declarative Pipeline中支持的步骤。

script

script步骤需要一个script Pipeline，并在Declarative Pipeline中执行。对于大多数用例，script在Declarative Pipeline中的步骤不是必须的，但它可以提供一个有用的加强。

Example

  1. script
  2. pipeline {
  3.     agent any
  4.     stages {
  5.         stage('Example') {
  6.             steps {
  7.                 echo 'Hello World'
  9.                 script {
  10.                     def browsers = ['chrome', 'firefox']
  11.                     for (int i = 0; i < browsers.size(); ++i) {
  12.                         echo "Testing the ${browsers[i]} browser"
  13.                     }
  14.                 }
  15.             }
  16.         }
  17.     }
  18. }

四、Scripted Pipeline

Groovy脚本不一定适合所有使用者，因此jenkins创建了Declarative pipeline，为编写Jenkins管道提供了一种更简单、更有主见的语法。但是不可否认，由于脚本化的pipeline是基于groovy的一种DSL语言，所以与Declarative pipeline相比为jenkins用户提供了更巨大的灵活性和可扩展性。

1.流程控制

pipeline脚本同其它脚本语言一样，从上至下顺序执行，它的流程控制取决于Groovy表达式，如if/else条件语句，举例如下：

  1. Jenkinsfile (Scripted Pipeline)
  2. node {
  3.     stage('Example') {
  4.         if (env.BRANCH_NAME == 'master') {
  5.             echo 'I only execute on the master branch'
  6.         } else {
  7.             echo 'I execute elsewhere'
  8.         }
  9.     }
  10. }

pipeline脚本流程控制的另一种方式是Groovy的异常处理机制。当任何一个步骤因各种原因而出现异常时，都必须在Groovy中使用try/catch/finally语句块进行处理，举例如下：

  1. Jenkinsfile (Scripted Pipeline)
  2. node {
  3.     stage('Example') {
  4.         try {
  5.             sh 'exit 1'
  6.         }
  7.         catch (exc) {
  8.             echo 'Something failed, I should sound the klaxons!'
  9.             throw
  10.         }
  11.     }
  12. }

2.Steps

正如文档开始所言，pipeline最核心和基本的部分就是“step”，从根本上来说，steps作为Declarative pipeline和Scripted pipeline语法的最基本的语句构建块来告诉jenkins应该执行什么操作。
Scripted pipeline没有专门将steps作为它的语法的一部分来介绍，但是在Pipeline Steps reference这篇文档中对pipeline及其插件涉及的steps做了很详细的介绍。如有需要可参考jenkins官网对该部分的介绍Pipeline Steps reference

3.Differences from plain Groovy

由于pipeline的一些个性化需求，比如在重新启动jenkins后要求pipeline脚本仍然可以运行，那么pipeline脚本必须将相关数据做序列化，然而这一点 Groovy并不能完美的支持，例如collection.each { item -> /* perform operation */ }

4.Declarative pipeline和Scripted pipeline的比较

共同点：
两者都是pipeline代码的持久实现，都能够使用pipeline内置的插件或者插件提供的steps，两者都可以利用共享库扩展。
区别：
两者不同之处在于语法和灵活性。Declarative pipeline对用户来说，语法更严格，有固定的组织结构，更容易生成代码段，使其成为用户更理想的选择。但是Scripted pipeline更加灵活，因为Groovy本身只能对结构和语法进行限制，对于更复杂的pipeline来说，用户可以根据自己的业务进行灵活的实现和扩展。

[持续交付实践] pipeline使用：语法详解的更多相关文章

  1. [持续交付实践] pipeline使用：项目样例

    项目说明 本文将以一个微服务项目的具体pipeline样例进行脚本编写说明.一条完整的pipeline交付流水线通常会包括代码获取.单元测试.静态检查.打包部署.接口层测试.UI层测试.性能专项测试( ...

  2. 自动化集成：Pipeline流水语法详解

    前言:该系列文章,围绕持续集成:Jenkins+Docker+K8S相关组件,实现自动化管理源码编译.打包.镜像构建.部署等操作:本篇文章主要描述Pipeline流水线用法. 一.Webhook原理 ...

  3. [持续交付实践] pipeline使用：Multibranch Pipeline

    前言 在探讨multiBranch Pipeline之前,很有必要先探讨下如何制定有效的代码分支管理规范,使用高效的版本控制系统,并对构建产物及其依赖进行管理.我们首先要强调,需要进行版本控制的不仅是 ...

  4. [持续交付实践] pipeline使用：快速入门

    什么是pipeline 先介绍下什么是Jenkins 2.0,Jenkins 2.0的精髓是Pipeline as Code,是帮助Jenkins实现CI到CD转变的重要角色.什么是Pipeline, ...

  5. Docker入门与实践之 Dockerfile 语法详解

    一.Dockerfile 概述 Dockerfile是docker程序的解释脚本文件,Dockerfile 是一条一条的指令,Docker程序将dockerfile中的一条条指令编译成Linux可执行 ...

  6. [持续交付实践] pipeline使用：Shared Libraries

    前言 随着pipeline交付流水线在团队中的推广,使用pipeline脚本的job也迅速增加.虽然我们已经基于公司的技术栈特点做了一个尽可能通用的pipeline脚本样例,让搭建者只需要修改几个赋值 ...

  7. Hadoop Hive sql语法详解

    Hadoop Hive sql语法详解 Hive 是基于Hadoop 构建的一套数据仓库分析系统,它提供了丰富的SQL查询方式来分析存储在Hadoop 分布式文件系统中的数据,可以将结构 化的数据文件 ...

  8. Vue.js 数据绑定语法详解

    Vue.js 数据绑定语法详解 一.总结 一句话总结:Vue.js 的模板是基于 DOM 实现的.这意味着所有的 Vue.js 模板都是可解析的有效的 HTML,且通过一些特殊的特性做了增强.Vue ...

  9. [转帖]helm模板文件chart编写语法详解

    helm模板文件chart编写语法详解 https://blog.51cto.com/qujunorz/2421328 需要学习一下. charts编写介绍 开始 快速创建一个chart模板,helm ...

随机推荐

  1. python xml文件解析

    参考链接:http://www.runoob.com/python/python-xml.html

  2. idea2017.3最新破解方法

    IntelliJ IDEA2017.3 激活  转载至:http://blog.csdn.net/zx110503/article/details/78734428 最新的IDEA激活方式 使用网上传 ...

  3. <a></a>标签传参出现乱码问题

    在段代码在传递参数的时候会出现中文乱码,正常情况下,只要在接收参数的时候写上: request.setCharacterEncoding("UTF-8");就能解决问题. 但是,今 ...

  4. Linux系统-tcpdump常用抓包命令

    主要语法 过滤主机/IP: tcpdump -i eth1 host 172.16.7.206 抓取所有经过网卡1,目的IP为172.16.7.206的网络数据 过滤端口:  tcpdump -i e ...

  5. python爬虫出现的状态码

    1.200 --- 一切正常访问 2.301 --- 重定向新的url,永久性的 3.302 --- 重定向到临时url 4.304 --- 请求的资源未更新 5.400 --- 非法请求 6.401 ...

  6. 读取Excel表格中数据原型

    写下这篇博客来记录自己的工作,这部分功能是读取Excel表格中的数据,并通过c#中的datagridview控件将读取的数据显示出来.为了方便用户,我设计了一个read按钮,用户点击这个按钮,会弹出打 ...

  7. Js/使用js来改变图片的url

    1.使用js的方式来改变url地址: $('#a1').attr("src","test1.jpg");这种方式来改变图片的url地址: 而不是采用$('#a1 ...

  8. C/C++ 宏技巧

    1. C 也可以模板化 #define DEFINE_ARRAY_TYPE(array_type_, element_type_) \ static inline int array_type_ ## ...

  9. Linux系统下用find命令查找最近修改过的文件

    1.先进入指定目录,比如:cd /var/ftp/ss 2.输入指定命令,相关命令如下介绍: 最近24小时内修改过的文件 find ./ -mtime 0 前48~24小时修改过的文件 find ./ ...

  10. 关于C语言实现判断给定一个数，判断其是否是一个质数(素数)。

    Annotation:⒈我们需要明确0,1既不是质数,又不是合数.⒉其次我们需要知道一个质数,质数定义为在大于1的自然数中,除了1和它本身以外不再有其他因数.(自然数:自然数用以计量事物的件数或表示事 ...