Jenkins教程——从安装到部署Docker服务(二)声明式流水线HelloWorld
前言
本文通过一个声明式流水线的HelloWorld程序做一下流水线基础入门,对常用的流水线参数进行简要说明
什么是流水线
现实中的流水线
流水线比较好理解,类比于现实生活中的生产流水线,每个流程只做一件事,通过传送带把这些流程连接在一起,一个流程完成后的结果交由后续流程继续操作。
Jenkins的流水线简单认知
Jenkins的流水线也是这样工作的,最简单的认知是它可以把若干可通用的Shell脚本像胶水一样连接起来,虽然这个比喻比较形象,但这只是流水线的冰山一角。
Jenkins流水线的两种形式
在Jenkins升级2.x版本之前,流水线只有一种脚本式流水线(Script Pipeline),当升级2.x版本后,新增了声明式流水线(Declarative Pipeline)
什么是Jenkinsfile
无论是哪种流水线,都需要为流水线定义流水线脚本,称之为Jenkinsfile
,使用Groovy语法写成
脚本式流水线
在说明声明式流水线前,有必要了解一下脚本式流水线的基本概念,这样有利于我们知道声明式流水线的好处与脚本式流水线的限制
特征
在脚本化流水线语法中, 一个或多个 node
块在整个流水线中执行核心工作。
限制
虽然这不是脚本化流水线语法的强制性要求, 但它限制了你的流水线的在node
块内的只能做两件事:
- 需要通过在Jenkins队列中添加一个项来调度块中包含的步骤。 节点上的执行器一空闲, 该步骤就会运行。
- 创建一个工作区(特定为特定流水间建立的目录),其中工作可以在从源代码控制检出的文件上完成。
基本语法
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
, 确定
第一次用Gimp截的图,有别的好用的截图并编辑工具请大家推荐波
这里的流水线与多分支流水线的区别我认为有两个,一个是流水线只能指定一个分支的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