一、pipeline job
jenkins pipeline的定义通常被写入到一个文本文件(称为Jenkinsfile)中,该文件可以呗放入项目的源代码控制中。
jenkinfile不一定叫做jenkinsfile,可以在源代码中定义。
二、创建一个简单的pipeline
pipeline {
agent any
stages{
stage('build'){
steps{
echo 'hello echo'
}
}
}
}
三、pipeline总体介绍
1.pipeline的组成
基本结构:以下每一个部分都是必须的,少一个Jenkins都会报错
pipeline: 代表整条流水线,包含整条流水线的逻辑
agent:指定流水线的执行位置,流水线中每个阶段都必须包含在某个地方(物理机/虚拟机/docker容器),agent部分指定具体在哪里执行
stage: 阶段,代表流水线的阶段,每个阶段都必须有名称
stages:流水线中多个stage的容器,stages部分至少包含一个stage
steps: 代表stage中的一个或多个具体步骤的容器,steps部分至少包含一个步骤
其他可选部分:
post: 包含的是在整个pipeline或stage完成后的附加步骤
always: 无论Pipeline运行的完成状态如何都会执行这段代码
changes: 只有当前Pipeline运行的状态与先前完成的pipeline的状态不同时,才会触发运行
failure: 当前完成状态为失败时执行
success: 当前完成状态为成功时执行
post{
always{
script{
allure includeProperties:false,jdk:'',report:'jenkins-allure-report',results:[[path:'allure-results']]
}
}
failure{
script{
if(gitpuller == 'noerr'){
mail to:"${email_list}",
subject:"[Jenkins Build Notification] ${JOB_NAME} - Build # ${Build_NUMBER} -构建失败!",
body: "'${env.JOB_NAME}' (${env.BUILD_NUMBER}) 执行失败了 \n请及时前往 ${env.BUILD_URL} 进行查看"
} else{
echo 'scm pull error ignore send mail'
}
}
}
}
pipeline支持的指令
environment: 用于设置环境变量,可定义在stage或pipeline部分,环境变量可以设置为全局的,也可以是阶段(stage)的。
tools: 可定义在pipeline或stage部分,会自动下载并安装指定的工具,并将其加入到PATH变量中
input: 定义在stage部分,会暂停pipeline,会提示你输入内容
options: 用于配置Jenkins pipeline本身的选项,options指令可以定义在stage或pipeline部分
parallel: 并行执行多个step
parameters: 与input不同,parameters是执行pipeline前传入的一些参数
triggers: 定义执行pipeline的触发器
when: 当满足when条件时,阶段才会执行
在使用指令时注意每个指令都有自己的作用域,如果指令使用的位置不正确,Jenkins会报错
了解webhooks
钩子功能(callback): 帮助用户push了代码后,自动回调一个设定的http地址,webhooks的请求方式为POST请求,有两种数据格式可以选择,JSON和web的form参数,可以自行选择是否使用密码来确定请求(注意:该密码是明文)