使用Jenkins持续集成maven项目

jenkins的使用

1. 前期准备

(1) 安装jdk

(2) 配置环境变量 JENKINS_HOME

JENKINS_HOME 是存放jenkins启动后数据和项目等文件的地方，如果没有配置，windows下自动默认为C:\Users\{当前登录用户}\.jenkins目录，linux默认为~\.jenkins

(3) 下载jenkins war包

点击这里下载

(4) 配置tomcat

配置tomcat的用户，在conf/tomcat-users.xml文件里面，这里要配置manager-script角色，并配置一个用户指定角色为manager-script

2.启动服务

(1) 启动

可以放在web服务器中运行，也可以直接java -jar jenkins.war运行，直接运行默认端口号为8080，可以在命令后面添加参数 –httpPort=8888 修改

(2) 登入

启动进入时提示需要输入AdminPassword，验证码在${JENKINS_HOME}/secrets/initialAdminPassword里面，或者在jenkins的启动日志里面也可以找到。然后是安装插件页面，选择推荐或者自定义都可以，最后设置管理员用户名和密码

3.配置

(1) 安装插件

系统管理>管理插件>可选插件，依次安装如下插件

• Deploy to container Plugin
• Maven Integration plugin
• Git plugin
• NodeJS Plugin
• Publish Over SSH
• SSH plugin

(2) 全局工具配置

系统管理>全局工具配置
JDK、Maven、NodeJs。配置过程都差不多，点击新增，别名随意填，如果系统已经安装过该软件，就不要勾选自动安装。XX_HOME填对应的安装目录

4. 添加项目

(1) 添加

点击新建，输入项目名，选择项目类型，这里选构建一个maven项目，点击确定

(2) 配置

① 项目名称

填写项目的名称

② 丢弃的构建

这里设置的是之前构建的项目保留的时间数量等，根据需要设置

③ 源码管理

选择git，输入仓库地址，如果需要登录点击Add，添加git远程仓库的用户名和密码，选择分支

④ 构建触发器

推荐使用最简单的配置“Poll SCM”，它的意思是，定时检查版本库，发现有新的提交就触发构建。这种方式对git、SVN等所有版本管理系统都是通用的。我们在日程中填入

*/3 * * * * 

表示每3分钟检查一次，如果有提交就触发构建

⑤ build

默认的Root POM是pom.xml。如果pom.xml不在根目录下，就填入子目录，例如：wxapi/pom.xml。
在Goals and options中，填入需要执行的mvn命令：clean package，Jenkins将执行如下命令：

mvn clean package

特殊参数也在这里填写，如-DskipTests=true

⑥ 构建后操作

选择增加构建后操作步骤：Deploy war/ear to a container
WAR/EAR files：指生成war包的位置，直接填**/*.war
Context path ：部署后应用的ContextPath
Add Container：添加容器，这里选择tomcat8，在Credentials中配置tomcat 中拥有manager-script角色的用户的用户名和密码，并配置tomcat的URL

5.构建项目

进入项目管理界面，点击立即构建可立即触发构建。点击Build History下面数字，Console Output可以查看控制台输出，如果最后显示Finished: SUCCESS说明构建成功

6.遇到的坑

(1) jenkins部署后无法进入

部署好jenkins后，第一次进入选择安装插件后显示 Unable to connect to jenkins 错误，错误解决方法地址，解决方法：

• 在打开浏览器访问jenkins页面前，将${JENKINS_HOME}/secrets/initialAdminPassword 文件内容最前面加”passwd:“,比如原来是“123456”,改成”passwd:123456”。
• 访问jenkins页面，使用用户名admin，密码为initialAdminPassword中passwd:之后的内容
• 点击[install suggested plugins]
• 点击 [continue as admin]
• 点击[start using Jenkins] 错误出现
• 点击[retry] 错误解决