1.Jnekins构建Maven项目
1.1Jenkins项目构建类型
(1)-Jenkins构建的项目类型介绍
Jenkins中自动构建项目的类型有很多，常用的有以下三种:\
- 自由风格软件项目(FreeStyle Project)
- Maven项目(Maven Project)
- 流水线项目(Pipeline Projct)
每种类型的构建其实都可以完成一样的构建过程与结果，只是在操作方式、灵活度等方面有所区别，在实际开发中可以根据自己的需求和习惯来选择。(PS:个人推荐使用流水线类型，因为灵活度非常高)
插件：Deploy to container
1.2Pipeline流水线类型
1.2.1Pipeline简介
1)概念
Pipeline，简单来说，就是一套运行在Jenkins 上的工作流框架，将原来独立运行于单个或者多个节点的作务连接起来，实现单个任务难以完成的复杂流程编排和可视化的工作。
2)使用Pipeline有以下好处(来自翻译自官方文档):
- 代码:Pipeline以代码的形式实现，通常被检入源代码控制，使团队能够编辑，审查和迭代其传送流程。
- 持久:无论是计划内的还是计划外的服务器重启，Pipeline都是可恢复的。
- 可停止:Pipeline可接收交互式输入，以确定是否继续执行Pipeline。
- 多功能:Pipeline支持现实世界中复杂的持续交付要求。它支持fork/join、循环执行，并行执行任务的功能。
- 可扩展:Pipeline插件支持其DSL的自定义扩展，以及与其他插件集成的多个选项。
3)如何创建Jenkins Pipeline呢?
- Pipeline 脚本是由 Groovy语言实现的，但是我们没必要单独去学习 Groovy。
- Pipeline 支持两种语法:Declarative(声明式)和 Scripted Pipeline(脚本式)语法。
- Pipeline 也有两种创建方法:可以直接在Jenkins 的 Web Ul 界面中输入脚本;也可以通过创建一个Jenkinsfile 脚本文件放入项目源码库中(一般我们都推荐在Jenkins 中直接从源代码控制(SCM)中直接载入Jenkinsfile Pipeline 这种方法)。
安装Pipeline插件
1.2.2创建Pipeline
1.2.2.1安装Popeline插件
下图是已经安装：
声明式
pipeline {
agent any
stages {
stage('pull code') {
steps {
echo 'pull code'
}
}
stage('build project') {
steps {
echo 'build project'
}
}
stage('publish project') {
steps {
echo 'publish project'
}
}
}
}
脚本式
node {
def mvnHome
stage('pull code') {
echo 'pull code'
}
stage('build project') {
echo 'build project'
}
stage('publish project') {
echo 'publish project'
}
}
构建阶段视图
构建日志
1.2.2流水线实际创建过程
1.2.2.1创建流水线任务
注意：任务名称必须是英文，不能含有中文，否则执行bat命令时会卡住
1.2.2.2配置流水线脚本
脚本详情
pipeline {
agent any
stages {
stage('pull code') {
steps {
// 拉取最新的代码
checkout scmGit(branches: [[name: '*/master']], extensions: [cloneOption(depth: 1, noTags: false, reference: '', shallow: true)], userRemoteConfigs: [[credentialsId: 'gitee-user-password', url: 'https://gitee.com/xuziliworkgitee/java-study.git']])
}
}
stage('build project') {
steps {
// 清理包并跳过测试
bat 'mvn clean package -DskipTests'
}
}
}
}
1.2.3使用Pipeline scipt form SCM
可以将流水线脚本存放到项目中，然后上传至版本控制系统，这样可以更规范的管理脚本和方便修改脚本。
一般都会在项目根目录下创建一个名为Jenkinsfile的文件，内容和之前一样。
然后配置流水线选择Pipeline scipt form SCM
2、构建触发器
Jenkins内置4种构建触发器
- 触发远程构建
- 其他工程构建后触发(Build after other projects are build)
- 定时构建(Build periodically)
- 轮询SCM(Pol SCM)
2.1触发远程构建
自己定义一个令牌，这里使用6666当作令牌，一般都是使用加密的字符串
看到下面的提示
JENKINS_URL/view/测试/job/TestPipeline/build?token=TOKEN_NAME
等于
http://localhost:10057/view/测试/job/TestPipeline/build?token=6666，访问地址Jenkins就是开始执行改流水线任务
2.2其他工程构建后触发
创建一个前置任务pre_job
然后在TestPipeline中选择Build after other projects are built，选择刚刚创建的前置任务pre_job
然后pre_job构建完成，Jenkins就会执行TestPipeline任务
2.3定时构建
定时字符串从左往右分别为:分 时 日 月 周 一些定时表单时的例子
每30分钟构建一次: H代表形参 H/3 * * * *
10:02 10:32
每2个小时构建一次: H H/2 * * *
每天的8点，12点，22点，一天构建3次(多个时间点中间用逗号隔开)：0 8,12,22 * * *
每天中午12点定时构建一次：H 12 * * *
每天下午18点定时构建一次：H 18 * * *
在每个小时的前半个小时内的每10分钟：H(0-29)/10 * * * *
创建定时构建，每两分钟执行一次：H/2 * * * *
2.4轮询SCM
轮询SCM，是指定时扫描本地代码仓库的代码是否有变更，如果代码有变更就触发项目构建。
每两分钟扫描一次代码仓库是否有变更，如果有变更，则执行构建
注意:这次构建触发器，Jenkins会定时扫描本地整个项目的代码，增大系统的开销，不建议使用。
2.5 Git Hook自动触发构建
刚才我们看到在inkins的内置构建触发器中，轮询SCM可以实现Gitlab代码更新，项目自动构建，但是该方案的性能不佳。那有没有更好的方案呢? 有的。就是利用Gitlab的webhook实现代码push到仓库，立即触发项目自动构建。
安装Gitlab和Gitlab hook
3 如何使用参数
3.1创建一个叫branch的参数
3.2点击构建就会提示输入参数
3.3脚本里面读取参数，使用${参数名}读取参数值
4 如何使用邮件服务
4.1安装Email Extension Template邮件插件
4.2开启邮箱的smtp服务
开启服务后会得到一个加密字符串
4.3配置Extended E-mail Notification邮箱参数
注意：如果想发送的邮件使用html文件渲染，就需要Default Content Type选择HTML (text/html)
4.4配置管理员邮箱
4.5 配置Jenkins自带的邮箱功能
4.6新增邮件模板email.html
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>${ENV, var="JOB_NAME"}-第${BUILD_NUMBER}次构建日志</title>
</head>
<body leftmargin="8" marginwidth="0" topmargin="8" marginheight="4"
offset="0">
<table width="95%" cellpadding="0" cellspacing="0"
style="font-size: 11pt; font-family: Tahoma, Arial, Helvetica, sansserif">
<tr>
<td>(本邮件是程序自动下发的，请勿回复！)</td>
</tr>
<tr>
<td><h2>
<font color="#0000FF">构建结果 - ${BUILD_STATUS}</font>
</h2></td>
</tr>
<tr>
<td><br />
<b><font color="#0B610B">构建信息</font></b>
<hr size="2" width="100%" align="center" /></td>
</tr>
<tr>
<td>
<ul>
<li>项目名称 ： ${PROJECT_NAME}</li>
<li>构建编号 ： 第${BUILD_NUMBER}次构建</li>
<li>触发原因： ${CAUSE}</li>
<li>构建日志： <a
href="${BUILD_URL}console">${BUILD_URL}console</a></li>
<li>构建 Url ： <a
href="${BUILD_URL}">${BUILD_URL}</a></li>
<li>工作目录 ： <a
href="${PROJECT_URL}ws">${PROJECT_URL}ws</a></li>
<li>项目 Url ： <a
href="${PROJECT_URL}">${PROJECT_URL}</a></li>
</ul>
</td>
</tr>
<tr>
<td><b><font color="#0B610B">Changes Since Last
Successful Build:</font></b>
<hr size="2" width="100%" align="center" /></td>
</tr>
<tr>
<td>
<ul>
<li>历史变更记录 : <a
href="${PROJECT_URL}changes">${PROJECT_URL}changes</a></li>
</ul> ${CHANGES_SINCE_LAST_SUCCESS,reverse=true, format="Changes for
Build #%n:<br />%c<br />",showPaths=true,changesFormat="<pre>[%a]<br
/>%m</pre>",pathFormat=" %p"}
</td>
</tr>
<tr>
<td><b>Failed Test Results</b>
<hr size="2" width="100%" align="center" /></td>
</tr>
<tr>
<td><pre
style="font-size: 11pt; font-family: Tahoma, Arial, Helvetica,
sans-serif">$FAILED_TESTS</pre>
<br /></td>
</tr>
<tr>
<td><b><font color="#0B610B">构建日志 (最后 100行):</font></b>
<hr size="2" width="100%" align="center" /></td>
</tr>
<tr>
<td><textarea cols="80" rows="30" readonly="readonly"
style="font-family: Courier New">${BUILD_LOG,
maxLines=100}</textarea>
</td>
</tr>
</table>
</body>
</html>
${BUILD_NUMBER}像这种是Jenkins的全局变量，可以在Content Token Reference找到
4.8构建完成发送邮件
新增如下脚本：不管构建成功或失败都会执行发送邮件，并且邮件的内容根据email.html文件模板。
post {
//不管构建成功或失败都会执行
always {
emailext(
subject: '构建通知：${PROJECT_NAME} - Build # ${BUILD_NUMBER} -${BUILD_STATUS}!',
body: '${FILE,path="email.html"}',
to: 'xxx@qq.com'
)
}
}
4.9若遇到邮件内容未乱码则，配置如下环境变量并重启Jenkins
JAVA_TOOL_OPTIONS
-Dfile.encoding=UTF8 -Dsun.jnu.encoding=UTF-8
