Windows下Jenkins+SVN+Maven+Tomcat的整合

这篇Jenkins的笔记只用到了本地一台机器，需要先安装好所有的组件，包括Jenkins、TortoiseSVN、VisualSVN Server、Maven、JDK8、Tomcat8，以及一个事先准备好的带maven的Java项目，这里我用的是自己的毕设…

1.SVN的准备

启动VisualSVN Server，新建名为SimulationEnvironment的repository，再找到要上传的项目，右键–TortoiseSVN–Import，在地址栏输入地址：
file:///D:/Repositories/SimulationEnvironment/dms
ok，等待上传完毕，在VisualSVN Server中刷新，就可以看到上传的项目了
再在下面的Users和Groups在新建用户和组，把用户添加到组里面
在一个新的文件夹下，导出这个项目：

这里导出是为了必要时改代码，因为只有导出后的代码才能提交，Jenkins才能去更新和打包实时的代码

2.Tomcat的准备

在tomcat的conf目录下，编辑tomcat-user.xml，新增：

  <role rolename="manager-gui"/>
  <role rolename="manager-script"/>
  <role rolename="manager-jmx"/>
  <role rolename="manager-status"/>
  <user username="tomcat" password="s3cret" roles="manager-gui,manager-script,manager-jmx,manager-status"/>

这里我也不太明白，我看的教程里面就要这么配…
在webapps下，要保留manager项目

3.Jenkins的预先配置

我安装Jenkins用的是install的exe文件，所以本地配置可能会有些不同，比如修改Jenkins默认使用的8080端口，在安装目录下，修改jenkins.xml的arguments标签：

<arguments>-Xrs -Xmx256m -Dhudson.lifecycle=hudson.lifecycle.WindowsServiceLifecycle -jar "%BASE%\jenkins.war" --httpPort=9090 --webroot="%BASE%\war"</arguments>

把–httpPort改成9090

服务列表中启动Jenkins，访问URL：http://127.0.0.1:9090

第一次访问会提示你输入admin密码，这个密码会在Jenkins安装目录下的/secrets/initialAdminPassword 中保存，也可以自己建一个管理员账号，之后还会提示你安装一些经典的插件，选择安装就是了。进入首页后是没有项目的的，右边是会提示要你新建，我这里会有是因为这是一篇总结而非教程…

左侧，系统管理–插件管理，搜索Deploy to container，必须安装这个插件，项目才能部署到tomcat上面去，这个下载超时是常态，建议去开源镜像库里下好hpi文件，再去“Advanced” 的“Upload plugin”上传安装。

https://mirrors.tuna.tsinghua.edu.cn/jenkins/plugins/

左侧，系统管理–全局工具配置
Maven Configuration:

选中自己本地的setting.xml
JDK:

记得取消自动安装
Maven:

同上记得取消自动安装

4.Jenkins部署项目

左侧新建任务，输入名称，选择“构建一个自由风格的软件项目”，ok
在“Source Code Management”栏里面，选择Subversion
先看Credentials，先点击Add，在弹出窗口中输入SVN的账号和密码
保存，再在Credentials的下拉框中，选择新增的这个账号，这里新建号账号以后，还是这个用户管理的项目就可以不用Add账号了

在Repository URL中填入项目导出的url：
file:///D:/Repositories/SimulationEnvironment/dms

在“Build”栏，Add一个“调用顶层Maven目标”，下拉框选中上面配置的MyMaven，Goals输入“clean install”

“Post-build Actions”栏，Add–Deploy war/ear to a container
files里面放的是打包的相对路径
path里是部署后请求地址中加上项目路径
Container中，Add Container，选中Tomcat 8.x， Credentials信息填写同上，把tomcat中配置的用户名和密码填入即可，再选中配置的tomcat账号信息，Tomcat URL中填写访问地址：

保存，部署项目成功，可以在工程dms的详情中的workspace目录下看到项目源码了

5.构建和调试

在项目详情的左侧，点击“立即构建”，在下面的Build History中可以看到构建进度条，鼠标放上去看到箭头后，点击箭头，在出现的弹框中，点击“Console Output”，可以看到项目构建的输出了，如果一切顺利，你就可以在浏览器上访问部署好的项目了

当然不会这么顺利…
Q1.打包项目没有把mybatis的mapper.xml打进去
Q2.spring-mybatis.xml在打好的war包中不存在
Q3.配置文件中有不能识别的UTF-8字符

解决，在pom.xml配置如下内容：

	<build>
		<finalName>Dms</finalName>
		<resources>
			<resource>
				<directory>src/main/java</directory>
				<includes>
					<include>**/*.xml</include>
				</includes>
				<filtering>true</filtering>
			</resource>
			<resource>
				<directory>src/main/resources</directory>
				<includes>
					<include>*.*</include>
				</includes>
				<filtering>true</filtering>
			</resource>
		</resources>
	</build>
	<properties>
		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>  
	</properties> 

这些都是项目的原因，移植项目的时候，要改好配置文件，添加一些配置，避免不必要的麻烦

Q4.部署失败，Connection refuse，拒绝连接
构建时必须把tomcat启动，Jenkins不会去检查tomcat是否启动

Q5.删除原来的项目失败，fail to delate dms.war
这属于不可抗力，重新再构建一遍大概率就可以了，也可以到tomcat的webapps下面删除，再重启tomcat