5-1 Jenkins Pipeline语法

1. 认识Pipleine

1.1 Pipeline是什么？

• Pipeline是Jenkins的核心功能，提供一组可扩展的工具。
• 通过Pipeline 的DSL语法可以完成从简单到复杂的交付流水线实现。
• jenkins的Pipeline是通过Jenkinsfile（文本文件）来实现的。
• 这个文件可以定义Jenkins的执行步骤，例如检出代码。

1.2 Jenkinsfile

• Jenkinsfile使用两种语法进行编写，分别是声明式和脚本式。
• 声明式和脚本式的流水线从根本上是不同的。
• 声明式是jenkins流水线更友好的特性。
• 脚本式的流水线语法，提供更丰富的语法特性。
• 声明式流水线使编写和读取流水线代码更容易设计。

1.3 为什么使用Pipeline？

本质上，jenkins是一个自动化引擎，它支持许多自动模式。流水线向Jenkins添加了一组强大的工具，支持用例、简单的持续集成到全面的持续交付流水线。 通过对一系列的发布任务建立标准的模板，用户可以利用更多流水线的特性，比如： - 代码化: 流水线是在代码中实现的，通常会存放到源代码控制，使团队具有编辑、审查和更新他们项目的交付流水线的能力。 - 耐用性：流水线可以从Jenkins的master节点重启后继续运行。 - 可暂停的：流水线可以由人功输入或批准继续执行流水线。 - 解决复杂发布： 支持复杂的交付流程。例如循环、并行执行。 - 可扩展性： 支持扩展DSL和其他插件集成。

构建一个可扩展是Jenkins的核心价值，流水线可以通过ShareLibrary的方式来扩展。 下面是一个CD的场景实例

2. Pipeline概念

参考文档：https://jenkins.io/zh/doc/book/pipeline/

2.1 node/agent(节点)

节点是一个机器，可以是Jenkins的master节点也可以是slave节点。通过node指定当前job运行的机器（这个是脚本式语法）。

• 声明式Pipeline: 使用agent指定运行的slave节点可以是label。

  pipeline{
  agent any
  stages{
     //    
  }
  
  }

• 脚本式Pipleine： 使用node指定运行slave可以是label。

  node("slave"){
  stage("GetCode"){
      //
  }
  }

2.2 stage(阶段)

stage定义了在整个流水线的执行任务的概念性的不同的阶段。例如： GetCode、Build、Test、Deploy、CodeScan每个阶段。

• 声明式pipeline： 定义stages->stage。

  pipeline{
  agent any
  stages{
      stage("GetCode"){
          //steps  
      }
          
      stage("build"){
         //step
      }
      
  }
  
  }

• 脚本式Pipeline: 直接使用stage。

  node("slave"){
  stage("GetCode"){
      //
  }
      
  stage("build"){
      //
  }
  }

2.3 step(步骤)

step是每个阶段中要执行的每个步骤。例如： 在执行GetCode的时候需要判断用户提供的参数srcType的值是Git还是svn。

• 声明式Pipeline: stage->steps。

  pipeline{
  agent any
  stages{
      stage("GetCode"){
          steps{ 
              sh "ls "    //step
          }
          
      }    
  }
  
  }

• 脚本式Pipeline： 不需要step关键字。

  node("slave"){
  stage("GetCode"){
      //step
      if("${srcType}" == "Git"){
          //用git方式代码检出
      } else if ("${srcType}" == "SVN"){
          //用svn方式代码检出
      } else {
          error "srcType is not in [Git|SVN]"
      }
  }
  }

3. Jenkinsfile生成与管理

3.1 BlueOcean（生成）

如果你是新手，Blue Ocean可以帮助你设置流水线，通过图形化流水线编辑器自动创建和编写Jenkinsfile。（需要安装blueocean 插件）

3.2 WEBUI（管理）

项目->配置

3.3 SCM（管理）

Jenkinsfile编写完成后上传到gitlab进行版本控制。

使用时，通过项目的配置gitlab仓库地址和分支信息以及文件名称信息。