文章目录
jenkins2.x支持Pipeline as code,可以通过Jenkinsfile用代码来部署流水线,使用jenkinsfile比界面操作的方式的好处:
- 更好的版本化,可以将Jenkinsfile提交到版本管理工具中(git、svn),进行版本控制;
- 更方便多人协作,也可以对流水线代码审查;
- 增加部署流水线脚本的重用。
1、Jenkinsfile语法选择
1.1 脚本式语法
使用Groovy语法实现pipeline,脚本式语法比较灵活和方便扩展,但是需要熟悉groovy语法。
node{stage("编译打包"){// groovy语法try{}catch(err){// 异常处理代码}}stage("部署"){}}
1.2 声明式语法
defgetversion(){def version ='1.0.0'return version;}
pipeline{
agent any
tools{
maven 'MAVEN_HOME'}
options {}
environment{{}
parameters {}
triggers{}
stages {stage('编译打包'){
environment {
DEBUG_FLAGS ='-g'}
echo '编译打包'}stage('部署'){
steps {
echo '部署'}}}
post {
always {}
success {}
failure{}}}
声明式语法更简单和结构化。
2、流水线语法介绍
插件的集成语法参考:https://www.jenkins.io/doc/pipeline/steps/
Jenkins pipeline是基于Groovy语言实现的DSL,用于描述流水线如何进行,包括编译、打包、部署、测试等等步骤
完整Jenkinsfile支持的内容
2.1 agent,执行位置
agent 指定了整个流水线或特定的阶段, 会在Jenkins环境中执行的位置(master节点或其它从节点运行)。可以在 pipeline 块的顶层被定义, 也可以在 stage 内定义。
any
在任何可用的代理上执行流水线或阶段。例如: agent any
none
当在 pipeline 块的顶部没有全局代理, 该参数将会被分配到整个流水线的运行中并且每个 stage 部分都需要包含他自己的 agent 部分。比如: agent none
label
在提供了标签的 Jenkins 环境中可用的代理上执行流水线或阶段。 例如: agent { label ‘my-defined-label’ }
node
agent { node { label ‘labelName’ } } 和 agent { label ‘labelName’ } 一样, 但是 node 允许额外的选项 (比如 customWorkspace )。
2.2 tool
Global Tool Configuration(全局工具配置)中配置的工具, tools指令能帮助我们自动下载并安装所指定的构建工具,并将其加入 PATH 变量中。这样,我们就可以在sh步骤里直接使用了。但在agent none的情况下不会生效。
tools指令默认支持3种工具:JDK、Maven、Gradle。通过安装插件,tools 指令还可以支持更多的工具。
tools {
git ‘Default’
jdk ‘JAVA_HOME’
maven ‘MAVEN_HOME’
}
2.3 environment
设置环境变量,可在在 pipeline中 或 stage配置
- 在 pipeline 中定义 environment, 表示 pipeline 全局使用的环境变量
- 在 stage 中定义 environment, 表示当前 stage 的环境变量
有三种引用方式:
- ${env.BUILD_NUMBER} 方式一,推荐使用
- $env.BUILD_NUMBER 方式二,
- ${BUILD_NUMBER} 方式三,不推荐使用
内置的环境变量:
使用环境变量
Jenkins 流水线通过全局变量 env 提供环境变量,它在 Jenkinsfile 文件的任何地方都可以使用。Jenkins 流水线中可访问的完整的环境变量列表记录在 ``${YOUR_JENKINS_URL}/pipeline-syntax/globals#env``,并且包括:
BUILD_ID
当前构建的 ID,与 Jenkins 版本 1.597+ 中创建的构建号 BUILD_NUMBER 是完全相同的。
BUILD_NUMBER
当前构建号,比如 “153”。
BUILD_TAG
字符串 ``jenkins-${JOB_NAME}-${BUILD_NUMBER}``。可以放到源代码、jar 等文件中便于识别。
BUILD_URL
可以定位此次构建结果的 URL(比如 http://buildserver/jenkins/job/MyJobName/17/ )
EXECUTOR_NUMBER
用于识别执行当前构建的执行者的唯一编号(在同一台机器的所有执行者中)。这个就是你在“构建执行状态”中看到的编号,只不过编号从 0 开始,而不是 1。
JAVA_HOME
如果你的任务配置了使用特定的一个 JDK,那么这个变量就被设置为此 JDK 的 JAVA_HOME。当设置了此变量时,PATH 也将包括 JAVA_HOME 的 bin 子目录。
JENKINS_URL
Jenkins 服务器的完整 URL,比如 https://example.com:port/jenkins/ (注意:只有在“系统设置”中设置了 Jenkins URL 才可用)。
JOB_NAME
本次构建的项目名称,如 “foo” 或 “foo/bar”。
NODE_NAME
运行本次构建的节点名称。对于 master 节点则为 “master”。
WORKSPACE
workspace 的绝对路径。
全局变量可以在搭建好的jenkins服务上查看,访问地址:http://jenkins访问地址/pipeline-syntax/globals#env
2.4 options 用于配置Pipeline本身
可用配置
**buildDiscarder**
为最近的流水线运行的特定数量保存组件和控制台输出。例如: options { buildDiscarder(logRotator(numToKeepStr: '1')) }
**disableConcurrentBuilds**
不允许同时执行流水线。 可被用来防止同时访问共享资源等。 例如: options { disableConcurrentBuilds() }
**overrideIndexTriggers**
允许覆盖分支索引触发器的默认处理。 如果分支索引触发器在多分支或组织标签中禁用, options { overrideIndexTriggers(true) } 将只允许它们用于促工作。否则, options { overrideIndexTriggers(false) } 只会禁用改作业的分支索引触发器。
**skipDefaultCheckout**
在`agent` 指令中,跳过从源代码控制中检出代码的默认情况。例如: options { skipDefaultCheckout() }
**skipStagesAfterUnstable**
一旦构建状态变得UNSTABLE,跳过该阶段。例如: options { skipStagesAfterUnstable() }
**checkoutToSubdirectory**
在工作空间的子目录中自动地执行源代码控制检出。例如: options { checkoutToSubdirectory('foo') }
**timeout**
设置流水线运行的超时时间, 在此之后,Jenkins将中止流水线。例如: options { timeout(time: 1, unit: 'HOURS') }
**retry**
在失败时, 重新尝试整个流水线的指定次数。 For example: options { retry(3) }
**timestamps**
预谋所有由流水线生成的控制台输出,与该流水线发出的时间一致。 例如: options { timestamps() }
2.5 parameters 流水线参数(参数化构建)
2.5.1 普通参数
参数类型包括:单行文本、布尔、 多行文本、选项、密码
parameters {
// 单行文本参数
string(name: 'user', defaultValue: '', description: '用户参数')
// 布尔参数
booleanParam(name: 'is_build', defaultValue: true, description: '是否构建')
// 多行文本参数
text(name: 'welcome_text', defaultValue: 'One\nTwo\nThree\n', description: '多行文本参数')
// 选项参数
choice(name: 'select', choices:['请选择','编译打包','部署','启动','关闭','回滚'
],description: '操作(请选择操作:编译打包、部署、启动、关闭、状态)')
// 密码参数
password(name: 'psw', defaultValue: '123456', description: '密码')
}
其它参数可以通过安装插件实现,比如Extended Choice Parameter(复选框插件)。
extendedChoice(description: '服务器(仅在部署、启动、关闭、状态操作时需要选择)', value: '192.168.1.100,192.168.1.101',
descriptionPropertyValue: '192.168.1.100(测试),192.168.1.101(正式)',
multiSelectDelimiter: ',', name: 'servers', quoteValue: false, saveJSONParameterToFile: false, type: 'PT_CHECKBOX', visibleItemCount: 5)
在阶段中调用上边设置的参数
stage('编译打包') {
steps {
script {
if (params.is_build == true) {
build()
}
else{
echo "=====跳过编译打包"
}
}
}
}
stage('部署') {
steps {
script {
if ("${params.select}".trim() == "部署") {
for(ip in servers.tokenize(",")){
deploy(ip)
}
}
}
}
}
2.5.2 特殊参数input
input会暂停Pipeline的执行,直到用户输入参数
## 配置选项
message(必需):提示的文本内容;
id(可选):可选标识符,默认为stage名称。
ok(可选):"ok" 按钮的显示的文本。
submitter(可选):允许操作的用户ID或角色名,默认允许任何用户。
submitterParameter(可选):环境变量的可选名称。如果存在,用 submitter 名称设置。
parameters(可选):可选的参数列表。
stages {stage('部署'){
input '是否确认部署或停止?'
steps {deploy(ip)}}}
input支持内部使用普通参数(单行文本、布尔、选项参数等)
stages {stage('Example'){
stages {stage('部署'){
message "是否确认部署或停止?"
ok '部署'
submitter "alice,bob"
parameters {extendedChoice(name:'servers', description:'服务器', value:'192.168.1.100,192.168.1.101',
descriptionPropertyValue:'192.168.1.100(测试),192.168.1.101(正式)',
multiSelectDelimiter:',', quoteValue:false, saveJSONParameterToFile:false, type:'PT_CHECKBOX', visibleItemCount:5)string(name:'myparam', defaultValue:'dev', description:'自定义参数')}
steps {deploy(ip)}}}}}
2.6 triggers触发器
Jenkins内置支持cron、pollSCM、upstream三种方式
2.6.1 定时执行
定时执行就像cronjob一样,一到时间点就执行。Jenkins采用了UNIX任务调度工具CRON的配置方式,用5个字段代表5个不同的时间单位(中间用空格隔开),语法如下:
字段*****含义分钟小时日期月份星期取值范围0-590-231-311-120-7
pipeline{
......
triggers{
cron('0 * * * *')
}
......
}
2.6.2 轮询代码仓库:pollSCM
定期到代码仓库轮询代码是否有变化,如果有变化就执行。
pipeline{
......
triggers{
pollSCM('H/1 * * * *')
}
......
}
2.6.3 事件触发
其它事件触发了pipeline执行,这个事件可以是在界面上手动触发、其它job触发、Http API Webhook触发等。
2.6.3.1 由上游任务触发:upstream
可以利用上游Job的运行状态来进行触发
pipeline{
agent any
//说明:当test_1或者test_2运行成功的时候,自动触发
triggers { upstream(upstreamProjects: 'test_1,test_2', threshold: hudson.model.Result.SUCCESS) }
stages{
stage("stage1"){
steps{
echo "hello"
}
}
}
}
hudson.model.Result是一个枚举,包括以下值:
ABORTED 任务被手动中止
FAILURE 构建失败
SUCCESS 构建成功
UNSTABLE 存在一些错误,但不至于构建失败
NOT_BUILT 在多阶段构建时,前面阶段的问题导致后面阶段无法执行
注意:这种需要手动构建当前任务一次,让jenkins加载pipeline后,trigger指令才生效
2.6.3.2 Gitlab事件触发
当gitlab发现源代码有变化时,触发jenkins执行构建。
(1)需要安装插件
- GitLab Plugin(https://plugins.jenkins.io/gitlab-plugin)
- Git plugin(https://plugins.jenkins.io/git/)
(2)在pipeline中实现Gitlab trigger
pipeline {
agent any
triggers {
gitlab(triggerOnPush: true,
triggerOnMergeRequest: true,
branchFilterType: "All",
secretToken: "rvgtcxwufgbcsr56lftzr5a74vhjko0")
}
stages {
stage('pull') {
steps {
echo '拉取代码'
}
}
}
}
(3)进入GitLab项目的配置页,找到设置->集成选项,把Jenkins暴露webhook及secretToken填入相应选项。
3、post,根据stages执行结果预定义的执行条件
post支持的条件块
- always: 无论stage的执行结果如何,此块中的预置操作都会执行。
- changed:只有当stage的执行后,当前状态与之前发生了改变时,此块中的预置操作才会执行。
- fixed:上一次运行为不稳定或者失败状态,本次运行成功时,此块中的预置操作才会执行。
- regression:上一次运行成功,本次运行为失败、不稳定、中止状态时,此块中的预置操作才会执行。
- aborted:当手动中止运行时,此块中的预置操作才会执行。
- failure:当stage的状态为失败时,此块中的预置操作才会执行。
- success:当stage的状态为成功时,此块中的预置操作才会执行。
- unstable: 当前stage的状态为不稳定时,此块中的预置操作才会执行。
- unsuccessful:当前stage的状态不是成功时,此块中的预置操作才会执行。
- cleanup:无论stage的状态为何种状态,在post中的其他的条件预置操作执行之后,此块中的预置操作就会执行。
3.1、企业微信通知
需要安装插件Qy Wechat Notification,唯一不足当前插件不支持自定义文本。
post {
always {
qyWechatNotification mentionedId: '', mentionedMobile: '', webhookUrl: 'https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxxxxxxxxxx'
}
}
3.2、Http请求通知
需要安装插件HTTP Request,与第三方系统集成的常用方式
post {
always {
httpRequest requestBody: '{\'build\':\'${env.BUILD_ID}\'}', responseHandle: 'NONE', url: 'http://192.168.1.100:8080/noti'
}
}
4、流水线支持的步骤
Pipeline支持的基本步骤(内置步骤),详细可查看(https://www.jenkins.io/doc/pipeline/steps/workflow-basic-steps/):
catchError: 捕捉错误和设置构建结果为失败。
deleteDir: 在工作区内递归删除当前目录
dir: 设置当前工作目录。
echo: 打印信息
error: 设置构建结果和阶段结果为异常,并打印设置的信息,可以中断流水线的执行,也可以抛出新的Exception(),但是这个步骤不会打印堆栈信息。
fileExists: 检查文件是否存在,返回true|false。
isUnix: 检查是否运行在类unix节点上
mail: 邮件通知
pwd: 以字符串形式返回当前目录路径。
readFile: 从相对路径读取文件(通常是工作空间),并以普通字符串的形式返回其内容。
retry: 重试内部代码N次。
sleep: 暂停管道构建,直到给定的时间过期。
stash: 在构建的阶段中把文件保存起来,这个文件可以给当前构建中的其它阶段使用。
step: 一般的构建步骤
timeout: 设置执行超时时间,如果块内的代码执行时间超出限制,会抛出异常。
tool: 使用预定义的工具安装中的工具,参考2.2。
unstable: 设置构建结果和阶段结果设置为不稳定。并打印日志信息。
unstash: 取出之前stash保存的文件。
waitUntil: 反复运行它的内部代码块,直到返回true。如果返回false,等待一段时间并再次尝试。
warnError: 捕获错误并将构建和阶段结果设置为不稳定
withEnv: 设置环境变量
wrap: 一般构建包装
writeFile: 将给定的内容写入当前目录中。
archive: 把构建中输出的内容存档,供以后其它构建使用。Jenkins 2.x后,提供archiveArtifacts代替archive,该步骤已弃用。
getContext: G从内部api获取上下文对象。
unarchive: 将存档的工件复制到工作区中。
withContext: 在块内部使用上下文对象 API。
5、其它支持Jenkinsfile的插件
5.1 文件上传
支持SSH文件上传的插件目前主要有Publish Over SSH、SSH Pipeline Steps,
5.1.1 Publish Over SSH
需要先在全局配置中配置远程服务器信息
Jenkinsfile中脚本代码:
stage('部署和启动'){sshPublisher(
publishers:[sshPublisherDesc(
configName:"192.168.28.129_test1",
transfers:[sshTransfer(cleanRemote:false,
excludes:'',
execCommand:"""
cd ${deploy_dir} // 远程执行的shell
""",
execTimeout:120000,
flatten:false,
makeEmptyDirs:false,
noDefaultExcludes:false,
patternSeparator:'[, ]+',
remoteDirectory:"upload",// 远程目录
remoteDirectorySDF:false,
removePrefix:"penneo/",// 删掉的去缀
sourceFiles:"penneo/test.zip")// 上传的文件],
usePromotionTimestamp:false,
useWorkspaceInPromotion:false,
verbose:true)])}
5.1.2 SSH Pipeline Steps
node {
def remote = [:]
remote.name = ‘test’
remote.host = ‘192.168.28.129’
remote.user = ‘penngo’
remote.password = ‘123456’
remote.allowAnyHosts = true
stage(‘Remote SSH’) {
writeFile file: ‘abc.sh’, text: ‘ls’
sshCommand remote: remote, command: ‘ls -al’
sshPut remote: remote, from: ‘abc.sh’, into: ‘.’
sshGet remote: remote, from: ‘abc.sh’, into: ‘bac.sh’, override: true
sshScript remote: remote, script: ‘abc.sh’
sshRemove remote: remote, path: ‘abc.sh’
}
}
也可以结合withCredentials使用
配置凭证信息,分别配置了ssh key和帐号密码两种方式
stages {stage('部署'){
steps {
script{def ip ='192.168.28.132'withCredentials([sshUserPrivateKey(credentialsId:"${ip}_pk", keyFileVariable:'identity', usernameVariable:'username')]){def remote =[:]
remote.name = ip
remote.host = ip
remote.allowAnyHosts=true
remote.user = username
remote.identityFile = identity
sshCommand remote: remote, command:"""
pwd
ls -al
"""// 把远程主机文件下载到本地工作区
sshGet remote: remote, from:'build_id.txt', into:'build2_id.txt', override:true// 本地工作区文件上传到远程主机目录
sshPut remote: remote, from:'JApiTest.zip', into:'/data/upload/'}withCredentials([usernamePassword(credentialsId:"${ip}", passwordVariable:'password', usernameVariable:'username')]){def remote =[:]
remote.name = ip
remote.host = ip
remote.user = username
remote.password = password
remote.allowAnyHosts=true
sshCommand remote: remote, command:"""
cd /usr/local
pwd
ls -al
"""
sshGet remote: remote, from:'build_id.txt', into:'build2_id.txt', override:true
sshPut remote: remote, from:'JApiTest.zip', into:'/data/upload/'// sshScript remote: remote, script: 'server.sh'
sshRemove remote: remote, path:'/root/ttt_test'}}}}}
Jenkins Pipelin支持的所有步骤列表:https://www.jenkins.io/doc/pipeline/steps/
版权归原作者 penngo 所有, 如有侵权,请联系我们删除。