Jenkins安装及配置maven任务

本文将介绍Jenkins安装和使用的方法，涉及安装依赖、添加插件和环境配置等必要设置。

安装

安装使用的是jenkins的docker镜像方式，安装步骤：

docker pull jenkins/jenkins:lts
docker run -d -v jenkins_home:/var/jenkins_home -p 8080:8080 -p 50000:50000 jenkins/jenkins:lts
//指定的端口号等参数可根据需要修改

启动成功后，访问指定的端口地址，如8080。网页中显示等待启动，第一次会比较慢。启动后会填写解锁密码，这个密码可以在启动时的命令行信息中找到，复制过来填入即可。
随后选择安装默认插件，安装完成填写管理员的账号和密码等信息，即可登录。

添加MAVEN等本地依赖

登录之后，已经可以新建任务了。但是我们需要的是新建maveng构建的项目，需要下载插件以及进行配置之后才能创建。本节先介绍如何将maven添加到镜像中，环境配置以及插件的添加，请查看之后两个小节。

安装maven：

1.下载maven

wget https://mirrors.tuna.tsinghua.edu.cn/apache/maven/maven-3/3.6.3/binaries/apache-maven-3.6.3-bin.tar.gz -P /tmp

2.将下载后的tar包解压至某个目录下，如/opt，将目录名修改为maven。
3.修改maven镜像源为国内源。
4.在jenkins环境配置中添加maven配置。

安装oracle jdk:

1.下载jdk。
2.将下载后的tar包解压至某个目录下，如/usr/local/，将目录名修改为jdk。
3.由于jenkins依赖jdk，所以要想jdk生效需要保存镜像并重启新的镜像。在启动的时候加上环境变量配置参数：PATH=/usr/local/jdk/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin和JAVA_HOME=/usr/local/jdk
4.在jenkins环境配置中添加jdk配置。

添加插件

由于有些功能例如maven任务、将构建后的文件上传至服务器等默认的jenkins中并不提供，所以需要以安装插件的方式实现。
在插件管理中，选择"高级"选项卡，将"升级站点"修改为国内源。

下载maven插件

在插件管理中，切换至"可选插件"选项卡，在过滤中输入"Maven Integration"，勾选对应的插件，点击安装。安装成功后，可在创建任务是选择"构建一个maven项目"。具体配置参见"配置一个任务"小节。

下载Publish over SSH插件

在"系统管理>管理插件"，选择"可选插件"，在输入框中输入"Publish over SSH"进行搜索，在搜索结果中选中"Publish over SSH"，点击页面的“直接安装”按钮，安装完成后先在"系统管理>配置"选项页配置全局设置，然后在maven任务配置中的"Post Steps"或"构建后操作"选择"Send build artifacts over SSH"，详细操作参看后面两节。

环境配置

待依赖安装完成后需要配置全局工具，比如JDK、MAVEN这些。

JDK设置

在系统管理-全局工具配置页面中找到"JDK"选项卡，点击"JDK安装…“按钮，此时会出现jdk配置信息选项页，取消勾选"自动安装”，填写JDK的别名以及JAVA_HOME的目录地址。

Git设置

填写name和系统中Git执行文件目录，这里笔者使用的是Jenkins镜像中自带的git，目录为/usr/bin/git。

Maven设置

点击"新增Maven"按钮，此时会出现maven配置信息选项页，取消勾选"自动安装"，填写maven的别名以及MAVEN_HOME的目录地址。

Publish over SSH配置

在系统管理-配置页面中，找到"Publish over SSH"选项，填写将要接收SSH文件的服务器信息以及公私钥。可以使用用户和密码的方式或是私钥两种方式。这里注意"Remote Directory"选项，后续CD过程中，传递的文件将保存至这个目录之下。

配置完成后点击保存。

配置一个任务

新建任务

输入任务名称，选择“构建一个maven项目”，点击确定按钮。

配置任务

"General"选项卡中描述中填入任务的描述信息。
“源码管理"选项卡中选择"Git”，填入项目的地址，以及认证配置（类型使用"Username with password"）、指定分支。
"构建触发器"按照默认设置，因为采用触发方式是在jenkins中点击触发。
"构建环境"按照默认设置。
"Pre Steps"按需添加
"Build"选项卡中"Root POM"填写pom.xml，"Goals and options"填写maven构建目标，比如clean、package等，也可以使用组合命令，如clean install。
"Post Steps"按需添加
"构建设置"不做设置
“构建后操作"中能够点击"增加构建后操作步骤”，选择"Send build artifacts over SSH"，选择配置的SSH服务器，然后填写"Transfer Set"设置，"Source files"填写发送的文件，这里注意地址是相对本工作目录的相对地址，比如任务的目录地址是/var/jenkins_home/workspace/rule-manager，则源文件地址是risk-manager-web，则绝对路径是/var/jenkins_home/workspace/rule-manager/risk-manager-web。相对目录地址可在任务信息中的"工作空间"属性中查看。"Remote directory"填写的是以系统配置"Publish over SSH"中填写地址为前缀的目录。"Exec command"填入需要执行的命令，使用脚本时注意系统目录地址和环境变量。
填写好后点击保存。

构建任务

点击任务的"立即构建"按钮，即可构建任务。构建任务输出信息可以在"控制台输出"选项中查看。

参考资料

https://github.com/jenkinsci/docker/blob/master/README.md
https://juejin.im/post/5be125c151882516d725a851#heading-0
https://www.cnblogs.com/effortsing/p/10375689.html
https://blog.csdn.net/russ44/article/details/51694074
https://blog.51cto.com/xiong51/2091739
https://blog.csdn.net/u012725714/article/details/100160238

Jenkins安装及配置maven任务