Pipeline是一套运行于Jenkins上的工作流框架，将原本独立运行于单个或者多个节点的任务连接起来，实现单个任务难以完成的复杂流程编排与可视化。它通过Domain Specific Language(DSL) syntax定义Pipeline As Code并且实现持续交付的目的。

Pipeline是Jenkins2.X的最核心的特性，帮助Jenkins实现从CI到CD与DevOps的转变。

注：Jenkins 1.0 只能通过UI界面手动操作来“描述”流水线; Jenkins 2.0 开始支持pipeline as code。

为什么要使用Pipeline：

1. 代码：Pipeline以代码的形式实现，通过被捡入源代码控制，使团队能够编译，审查和迭代其CD流程。

2. 可连续性：Jenkins重启或者中断后都不会影响Pipeline job。

3. 停顿：Pipeline可以选择停止并等待人工输入或者批准，然后在继续Pipeline运行。

4. 多功能：Pipeline支持现实世界的复杂CD要求，包括fork、join子进程，循环和并行执行工作的能力。

5. 可扩展：Pipeline插件支持其DSL的自动扩展以及其插件集成的多个选项。

Pipeline结构快速解析：

• 语法参考：https://www.jenkins.io/doc/book/pipeline/syntax/

Jenkins Pipeline的脚本语法是由Groovy语言实现，学习成本较低，简单易学。目前Jenkins Pipeline支持两种语法：

• Declarative声明式（在Pipeline plugin 2.5中引入）
• Scripted Pipeline脚本式

声明式Pipeline基本语法和表达式遵循Groovy语法，但是有以下例外：

• 声明式Pipeline必须包含在固定格式的pipeline{}块内
• 每个声明语句必须独立一行， 行尾无需使用分号
• 块(Blocks{})只能包含章节(Sections), 指令（Directives）, 步骤(Steps),或者赋值语句
• 属性引用语句被视为无参数方法调用。 如input()
• 块(Blocks{})

由大括号括起来的语句：如 Pipeline{}, Sections{}, parameters{}, script{}

• 章节(Sections)

通常包括一个或者多个指令或步骤 如 agent，post，stages，steps

• 指令(Directives)

environment, options, parameters, triggers, stage, tools, when

• 步骤(steps)

执行脚本式Pipeline，如script{}

Jenkins Pipeline包含两类元素：stages和steps。如下图：

Stage：阶段，一个Pipeline可以划分成若干个Stage，每个Stage代表一组操作，例如：“Build”，“Test”，“Deploy”。注意，Stage是一个逻辑分组的概念，可以跨多个Node。

Step：步骤，Step是最基本的操作单元，小到创建一个目录，大到构建一个Docker镜像，由各类Jenkins Plugin提供，例如：sh ‘make’ Node：节点，一个Node就是一个Jenkins节点，或者是Master，或者是Agent，是执行Step的具体运行环境。

pipeline{
    agent any
    stages {
        stage('Build') {
            steps{
                echo 'This is a build step' 
            }
        }
        stage('Test') {
            steps{
                echo 'This is a test step'  
            }
        }
        stage('Deploy') {
            steps{
                echo 'This is a deploy step'    
            }
        }
    }
}

Pipeline编写的辅助工具：

Snipper Generator（代码片段生成器，语法检查器）

Replay Pipeline

重放Pipeline，可以修改script，修改后的不存入config.xml

DSL Reference 语法参考手册

• 全局变量引用

Jenkinsfile本地校验

Jenkins Pipeline Linter Connector （vscode 插件）

如下图所示，插件按照后需要配置如下参数：

• jenkins.pipeline.linter.connector.url 是Jenkins期望的 POST请求地址，包含你要校验的Jenkinsfile文件。通常为 http:///pipeline-model-converter/validate。
• jenkins.pipeline.linter.connector.user 允许指定你的Jenkins用户名。
• jenkins.pipeline.linter.connector.pass 允许指定你的Jenkins密码。
• jenkins.pipeline.linter.connector.crumbUrl 当你的Jenkins启用了CRSF时必须指定。通常为 http:///crumbIssuer/api/xml?xpath=concat(//crumbRequestField,%22:%22,//crumb)。

Ctrl+Shift+P 执行如下命令，对编写的Jenkinsfile进行校验

Jenkins Declarative Parser

• https://brokenco.de/2020/12/25/jenkins-declarative-parser.html
• https://github.com/rtyler/jdp

❯ jdp check data/valid/complex-deployment/Jenkinsfile
Checking: data/valid/complex-deployment/Jenkinsfile
Looks valid! Great work!