持续交付-Jenkinsfile 语法

实现 Pipeline 功能的脚本语言叫做 Jenkinsfile，由 Groovy 语言实现。Jenkinsfile 一般是放在项目根目录，随项目一起受源代码管理软件控制，无需像创建"自由风格"项目一样，每次可能需要拷贝很多设置到新项目，提供了一些直接的好处：

• Pipeline 上的代码审查/迭代
• Pipeline 的审计跟踪
• Pipeline 的唯一真实来源，可以由项目的多个成员查看和编辑
  Pipeline 支持：Declarative（在 Pipeline 2.5 中引入）和 Scripted Pipeline 两种格式。两者都支持建立 Pipeline，两者都可以用于在 Web UI 中定义一个流水线 Jenkinsfile，将 Jenkinsfile 文件创建并检查到源代码控制库中通常被认为是最佳做法。

Declared Pipeline

Declared Pipeline树

Declared Pipeline 必须包含在固定格式 Pipeline {} 块内，每个声明语句必须独立一行，行尾无需使用分号。块（ blocks{} ）只能包含章节（Sections），指令（Directives），步骤（Steps）或赋值语句。

块 blocks{}

由大括号括起来的语句，如 Pipeline{}，Section{}，parameters{}，script{}

章节（Sections）

章节中通常包含一个或多个指令或步骤。如 agent 、post、stages、steps

指令（Directives）

environment、options、parameters、triggers（触发）、stage、tools、when

节点（agent）

必须存在，agent 必须在 Pipeline 块内的顶层定义，但 stage 内是否使用是可选的
参数：any/none/label/node/docker/dockerfile
常用选项 label/cuetomWorkspace/reuseNode
示例：

1. agent { label 'my-label' }

3. agent {

4. node {

5. label 'my-label'

6. customWorkspace '/some/other/path'

7. }

8. }

10. agent {

11. docker {

12. image 'nginx:1.12.2'

13. label 'my-label'

14. args '-v /tmp:/tmp'

15. }

16. }

构建后（post）

不是必须，用于 Pipeline 的最外层或者 stage{} 中，主要用于表达 Jenkins 完成构建动作之后需要做的事情。

示例：

1. pipeline {

2. agent any

3. stages {

4. stage('Example'){

5. steps {

6. echo 'Hello world'

7. }

8. }

9. }

10. post {

11. always {

12. echo 'say goodbay'

13. }

14. }

15. }

阶段集（stages）

必须存在，包括顺序执行的一个或多个 stage 命令，在 Pipeline 内仅能使用一次，通常位于 agent/options 后面。

步骤（steps）

必须存在，steps 位于 stage 指令块内部，包括一个或多个 step。仅有一个 step 的情况下可以忽略关键字 step 及其{}。

环境（environment）

不是必须，environment 定义了一组全局的环境变量键值对，存在于 pipeline {} 或者 stage 指令内。执行特殊方法 credentials()可以获取 Jenkins 中预定义的凭证明文内容。

示例：

1. environment {CC='clang'}

2. environment {AN_ACCESS_KEY = credentials('my-prefined-secret-text')}

3. steps {sh 'printenv'}

选项（options）

不是必须，预定义 Pipeline 专有的配置信息，仅可定义一次

示例：

1. pipeline {

2. agent any

3. options{

4. timeout(time:1,unit: 'HOURS')

5. }

6. }

参数（parameters）

不是必须， 定义参数化构建的参数可选参数， 参数类型 booleanParam，choice，file，text，password，run，string
示例：

1. parameters {

2. string(name: 'PERSON', defaultValue: 'Jenkins', description: '输入的文本参数')

3. choice(name: 'CHOICE', choices: ['One', 'Two', 'Three'], description: 'Pick something')

4. }

触发器（rtiggers）

不是必须，定义 Pipeline 被自动触发的方式选项 cron、pollSCM、upstream

示例：

1. triggers {

2. cron('0 8 * * 1-5')

3. }

Script Pipeline

Script Pipeline语句树

一个 Script Pipeline 可以划分成若干个 Stage，每个 Stage 代表一组操作，例如 Build，Test；Node 代表 Jenkins 节点，比如 Master, Slave 这样的节点；Step 是最基本的操作单元，在对应 Node 节点上执行的动作语句直接写在 node {} 中。

流程控制语句

如同传统的脚本语言一样，Script Pipeline 是从上至下顺序执行，可以使用 Groovy 表达式进行流程控制，如 if/else 语句通过逻辑条件判断来对流程进行控制：

1. node {

2. stage('Example') {

3. if (env.BRANCH_NAME == 'master') {

4. echo 'I only execute on the master branch'

5. } else {

6. echo 'I execute elsewhere'

7. }

8. }

9. }

异常处理语句

Script Pipeline 脚本流程控制的另一种方式是异常处理机制。当任何一个步骤因各种原因而出现异常时，都必须在代码中使用 try/catch/finally 语句块进行异常捕获，并通过预先设定代码进行处理，保证脚本能够顺利执行：

1. stage('Error Handling') {

2. node{

3. echo "This is test demo for the error handling"

5. try {

7. echo "This is in the try block."

9. sh 'exit 1'

11. }catch (exc) {

13. echo "Something failed, I'm in the catch block."

15. }finally {

17. echo "Finally, I'm in the finally block."

19. }

20. }

21. }

Jenkinsfile 中调用plugin功能

在 Jenkinsfile 中除了可以使用常规的逻辑、流程控制，还可以调用 Jenkins 的插件功能。下面用如下实例进行说明。

Email Extension插件

Email Extension 是 Jenkins 中的一个外部插件，用来发送邮件，从 Jenkins 的 Plugin Manager 中进行安装。在 Pipeline 中通过代码调用可以触发该插件的运行，实现发送邮件的功能。

基础配置

在安装好 Email Extension 插件之后，首先需要选择一个准备用来发送 Jenkins 通知邮件的邮箱，发件邮箱的具体参数要提前知晓（通常参数可以从邮箱的配置参数信息页面上查到）；之后要在 Manage Jenkins -> Configure System 中将对应参数填写该插件的对应配置项中，必须配置的参数如下：

• SMTP server：smtp 服务地址
• SMTP port：smtp 端口号
• Use SMTP Authentication：启用 smtp 安全校验
• User Name：发件人用户名
• Password：发件人密码
• Default Recipients：默认收件人
  其他的参数可以根据自己的需要进行配置，Email Extension 配置参考截图如下：

  

Pipeline代码

1. pipeline{

2. agent {

3. label 'master'

4. }

5. stages{

6. stage('发送邮件测试') {

7. steps{

8. echo 'Test Email'

9. }

10. }

11. }

12. post {

13. always {

14. emailext body: '$DEFAULT_CONTENT', recipientProviders: [[$class: 'RequesterRecipientProvider']], subject: '$DEFAULT_SUBJECT'

15. }

16. }

17. }

Declared Pipeline 的入门学习难度相对不高，这种类似我们在做自动化测试时所接触的关键字驱动模式，只要理解其定义好的关键词，按要求填充数据即可。
虽然这种方式入门容易，但灵活性欠缺。相比之下 script Pipeline 的好处就是灵活，好封装，易于大规模使用，但需要有一定的编程功底。

总结：

感谢每一个认真阅读我文章的人！！！

作为一位过来人也是希望大家少走一些弯路，如果你不想再体验一次学习时找不到资料，没人解答问题，坚持几天便放弃的感受的话，在这里我给大家分享一些自动化测试的学习资源，希望能给你前进的路上带来帮助。

软件测试面试文档

我们学习必然是为了找到高薪的工作，下面这些面试题是来自阿里、腾讯、字节等一线互联网大厂最新的面试资料，并且有字节大佬给出了权威的解答，刷完这一套面试资料相信大家都能找到满意的工作。

 

          视频文档获取方式：
这份文档和视频资料，对于想从事【软件测试】的朋友来说应该是最全面最完整的备战仓库，这个仓库也陪伴我走过了最艰难的路程，希望也能帮助到你！以上均可以分享，点下方小卡片即可自行领取。