Jenkins教程——从安装到部署Docker服务（二）声明式流水线HelloWorld

前言

本文通过一个声明式流水线的HelloWorld程序做一下流水线基础入门，对常用的流水线参数进行简要说明

什么是流水线

现实中的流水线

流水线比较好理解，类比于现实生活中的生产流水线，每个流程只做一件事，通过传送带把这些流程连接在一起，一个流程完成后的结果交由后续流程继续操作。

Jenkins的流水线简单认知

Jenkins的流水线也是这样工作的，最简单的认知是它可以把若干可通用的Shell脚本像胶水一样连接起来，虽然这个比喻比较形象，但这只是流水线的冰山一角。

Jenkins流水线的两种形式

在Jenkins升级2.x版本之前，流水线只有一种脚本式流水线（Script Pipeline），当升级2.x版本后，新增了声明式流水线（Declarative Pipeline）

什么是Jenkinsfile

无论是哪种流水线，都需要为流水线定义流水线脚本，称之为Jenkinsfile ，使用Groovy语法写成

脚本式流水线

在说明声明式流水线前，有必要了解一下脚本式流水线的基本概念，这样有利于我们知道声明式流水线的好处与脚本式流水线的限制

特征

在脚本化流水线语法中, 一个或多个 node 块在整个流水线中执行核心工作。

限制

虽然这不是脚本化流水线语法的强制性要求, 但它限制了你的流水线的在node块内的只能做两件事:

1. 需要通过在Jenkins队列中添加一个项来调度块中包含的步骤。 节点上的执行器一空闲, 该步骤就会运行。
2. 创建一个工作区(特定为特定流水间建立的目录)，其中工作可以在从源代码控制检出的文件上完成。

基本语法

Jenkinsfile (Scripted Pipeline)

node { //需要有一个或多个node节点表示一系列操作
    stage('Build') { //每个stage表示一个步骤
        // Build步骤内容
    }
    stage('Test') {
        //  Test步骤内容
    }
    stage('Deploy') {
        //  Deploy步骤内容
    }
}

声明式流水线的基本语法类似于脚本式流水线，但是其功能更加强大

声明式流水线基础

特征

声明式流水线最外层Jenkinsfile脚本节点是pipeline

与脚本式流水线不同点

声明式和脚本化的流水线从根本上是不同的。 声明式流水线的是 Jenkins 流水线更近的特性:

• 相比脚本化的流水线语法，它提供更丰富的语法特性,
• 是为了使编写和读取流水线代码更容易而设计的。

基础语法

Jenkinsfile (Declarative Pipeline)

pipeline { // pipeline是声明式流水线的一种特定语法，在块内定义了整个流水线的所有内容
    agent any //	agent是声明式流水线的一种特定语法，它指示 Jenkins 为整个流水线分配一个执行器 (在节点上)和工作区，等效于脚本式流水线node块
    stages { // 所有流程（状态）的外层块，仅有一个
        stage('Build') { //每个stage为一流程，与脚本式基本一致，每个stage可以定义名称
            steps {  //步骤块，内部包含具体操作
                sh 'make'  // sh操作，其引号间的文字会当成shell直接执行
            }
        }
        stage('Test'){
            steps {
                sh 'make check'
                junit 'reports/**/*.xml'  //junit使用匹配的定义测试xml进行单元测试
            }
        }
        stage('Deploy') {
            steps {
                sh 'make publish'
            }
        }
    }
}

声明式流水线HelloWorld

有了上边的基础，我们来写一个最简单的HelloWorld声明式流水线吧！

创建项目

点击左上角的新建项目（new item）

我们这里选择流水线，输入工程名称Hello Pipeline , 确定

这里的流水线与多分支流水线的区别我认为有两个：

• 一个是流水线只能指定一个分支的Jenkinsfile，还可以把脚本直接写到工程中，而多分支流水线可以指定多个分支的Jenkinsfile，但是不能把脚本写在工程中；
• SCM插件也支持多分支流水线，而单分支流水线没有

填写描述，勾选This project is parameterized

添加参数，选择String parameter

这里我们加一个参数，一个字符串参数，这样我们在Jenkinsfile中就可以取到这个值了

添加这个参数是为了让大家先有个参数化构建的准备

往下滑动，找到流水线，定义处可选直接写脚本还是走版本控制，这里直接使用脚本

在脚本处输入如下内容

pipeline {
    agent any;
    environment { //环境变量
		GREETING="Hello";
    }
    stages{
        stage('打招呼') {
            steps{
            	sh 'echo "$GREETING $TITLE"'
            }
        }
   }
   post { //构建完成后置操作
        aborted { //如果构建中断，则执行
            echo '构建被中止!'
        }
        success { //构建成功执行
            echo '构建成功!'
        }
       failure { //构建失败执行
           echo '构建失败!'
       }
    }
}

语法不会写怎么办？上边的图中有流水线语法(Pipeline-Syntax)，通过这个语法功能就可以生成部分脚本

点保存，我们去准备构建这个工程

点击Build with Parameters

这里我们看到刚才定义的参数值是可以修改的，有兴趣可以改下试试，然后开始构建

输出如下

把鼠标放在打招呼下边的绿色框上，点出现的logs

我们可以看到输出了预期的值

查看下Post Actions的日志

我们可以通过左下角的构建版本号，如当前是#1，点进去，选择Console Output查看详细的执行日志

细心会发现构建的工作空间在我们指定的Jenkins家目录/workspace/当前工程名内

声明式流水线HelloWorld工程就先写这些

后记

在家里的笔记本装的Debian用了一年了快，这次写文章截图用的Gimp