Jenkins+Svn+Ant+Tomcat

  之前使用过Jenkins搭建.net项目，也使用过Jenkins搭建maven项目。所以想当然地认为普通Java Web项目也是如此。真正实践后发现核心的一步——编译项目，各不相同。

1.Jenkins工作原理

  前提：我们的项目已上线，但是后续会不断补充功能进去。

  在没有Jenkins之前，我们是这样部署代码的。如果服务器上安装了Eclipse，那么我们把本地新开发的代码粘贴到Eclipse中已有的代码上去，使用Eclispe帮助我们编译。然后启动Tomcat运行查看效果。如果服务器上没有安装Eclipse，那么我们从本地编译好，完整地拷入Tomcat中。然后启动运行。这么一个过程中，即使是一个小小的改动，都需要如此的大费周章。有了Jenkins后，我们会发现，极大地减少了这些步骤得繁琐。我们只需要提交代码到SVN，登录Jenkins启动立即构建，就可以在浏览器中查看功能效果了。

  说了这么多，都是生活中具体使用的场景。那Jenkins的工作原理是什么呢？我们可以看一张图。

  从这张图中我们可以看到Jenkins似乎是一个核心。但是我却不这么认为，我觉得Jenkins就是一个空架子。主要工作都不是Jenkins做的。它做的就是把大家都整合起来。像一个管理者。在它的管理下，一切都连起来了，像是自动做的一样。合作开发使用SVN管理代码。Jenkins利用配置的SVN地址，从SVN服务器上获取最新代码，拷贝到自己的workspace里面。然后调用Ant脚本编译代码，打war包，且将war包拷贝到Tomcat的webapp目录下。Jenkins在调用Tomcat里面的命令重新启动Tomcat.这个过程就完成了部署代码。

2.准备工作

  安装JDK，Tomcat，Ant和Jenkins；配置的环境变量有：JAVA_HOME，ANT_HOME，path。

  安装完成后可以通过命令检测是否安装成功如：java -version;检查JDK；  ant - version;检查ant.

  Jenkins安装完成后，在计算机---管理---服务中开启Jenkins服务，然后在浏览器中输入localhost:8080就可以看到Jenkins页面。最好修改一下端口号，以免和Tomcat的端口冲突。

3.新建Job

  新建一个Job，输入名称，选择第一项自由风格的软件项目。如图：

  然后进行项目的具体的配置页,在源码管理这一项下：选择Subversion,然后输入Repository URL。

  在构建触发器这一项下，选择Poll SCM。输入*/5 * * * * ,意思为每5分钟检测一次源码变化。选择后面的？可以看到详细的设置方法。

  在构建这项下，我们选择三个步骤：第一Execute Windows batch command ,这一项输入net stop Tomcat6,意思为关闭Tomcat服务。（之前需要配置Tomcat为Windows的一项服务。具体操作这里略。请读者自己去网上查找）第二，Invoke Ant,可以选择默认安装的AntVersion，也就是环境变量中配置的版本。Targets处什么都不填，就是默认执行项目根目录下的Build.xml.如图。第三，Execute Windows batch command ,这一项输入net start Tomcat6,意思为开启Tomcat服务。整个实现先关闭Tomcat，然后编译，部署项目，最后重启Tomcat.

  最后保存配置就可以了。

4.Ant的build.xml文件分析

  使用Ant编译项目，主要就是bulid.xml文件如何写。这里我给出一个简单的模板。

<?xml version="1.0" encoding="UTF-8"?>
<project name="ItcastOA" default="deploy" basedir=".">
	<property environment="env" />
	<property name="webapp.name" value="ItcastOA" />
	<property name="catalina.home" value="D:\program\chaiqian\apache-tomcat-6.0.36" />
	<property name="dist.dir" value="${basedir}/dist" />
	<property name="ant.dir" value="D:\应用软件\jenkins\apache-ant-1.9.6-bin\apache-ant-1.9.6" />
	<property name="webRoot.dir" value="${basedir}/WebRoot" />
	<property name="src.dir" value="${basedir}/src" />
	<property name="config.dir" value="${basedir}/config" />
	<property name="lib.dir" value="${webRoot.dir}/WEB-INF/lib" />
	<property name="build.dir" value="${basedir}/build" />
	<!-- 使用eclipse jdt进行编译，而不使用JDK编译  -->
	<property name="build.compiler" value="org.eclipse.jdt.core.JDTCompilerAdapter" /> 

	<!-- 初始化classpath -->
	<path id="project.classpath">
		<fileset dir="${lib.dir}">
			<include name="**/*.jar" />
		</fileset>
		<!-- 添加tomcat类路径 -->
		<fileset dir="${catalina.home}/lib">
			<include name="*.jar" />
		</fileset>
		<!-- ant lib包  -->
		<fileset dir="${ant.dir}">
			<include name="**/*.jar" />
		</fileset>
	</path>

	<!-- get the source compile classpath in a printable form -->
	<pathconvert pathsep="${line.separator}|   |-- "
             property="echo.path.compile"
             refid="project.classpath">
	</pathconvert>
	
	<!-- show classpath jars -->
	<target name="print_classpath">
		<echo message="|-- compile classpath"/>
		<echo message="|   |"/>
		<echo message="|   |-- ${echo.path.compile}"/>
	</target>
	
	
	<!-- 删除之前的目录结构 -->
	<target name="clear" description="清理旧文件">
		<delete dir="${build.dir}" />
		<delete dir="${dist.dir}" />
		<delete file="${catalina.home}/webapps/${webapp.name}.war" />
		<delete dir="${catalina.home}/webapps/${webapp.name}" />
	</target>

	<!-- 创建目录结构 -->
	<target name="init" depends="clear" description="创建初始化目录结构">
		<mkdir dir="${build.dir}/classes" />
		<mkdir dir="${dist.dir}" />
	</target>

	<!-- 编译java -->
	<target name="compile" depends="init" description="编译java文件">
		<echo message="begin compile..." />
		<javac srcdir="${src.dir}" destdir="${build.dir}/classes" 
			includeantruntime="false" nowarn="on" 
			source="1.6" target="1.6" deprecation="true" debug="true" 
			encoding="UTF-8" classpathref="project.classpath" 
			>
			<compilerarg line="-Xlint:unchecked" />
			<!-- <classpath refid="project.classpath" /> -->
		</javac>
		<copy todir="${build.dir}">
			<fileset dir="${src.dir}">
				<include name="**/*.xml" />
				<include name="**/*.properties" />
				<include name="**/*.sql" />
			</fileset>
			<fileset dir="${config.dir}">
				<include name="**/*.xml" />
				<include name="**/*.properties" />
				<include name="**/*.sql" />
			</fileset>
		</copy>
		<echo message="end compile..." />
	</target>

	<!-- 将class文件打成 jar包 -->
	<!--  
	    <target name="pack" depends="compile"> 
	        <jar jarfile="${build.dir}/${webapp.name}.jar"> 
	            <fileset dir="${build.dir}/classes"> 
	                <include name="**/*.class"/> 
	            </fileset> 
	        </jar> 
	    </target> 
	-->

	<!-- 打成war包, 名称默认为 项目名 -->
	<target name="war" depends="compile" description="将工程打成war包">
		<echo message="begin war..." />
		<war destfile="${dist.dir}/${webapp.name}.war" basedir="${webRoot.dir}" 
			webxml="${webRoot.dir}/WEB-INF/web.xml">
			<lib dir="${lib.dir}" />
			<classes dir="${build.dir}/classes" />
			<fileset dir="${webRoot.dir}">
				<include name="***.*" />
			</fileset>
		</war>
		<echo message="end war..." />
	</target>

	<!-- copy war包 tomcat的deploy目录 -->
	<target name="deploy" depends="war" description="部署项目">
		<echo message="begin deploy..." />
		<copy file="${dist.dir}/${webapp.name}.war" todir="${catalina.home}/webapps" />
		<echo message="end deploy..." />
	</target>

</project>

  在该模板中只需要修改<property>下的路径就可以了。笔者认为Ant编译文件时整个研究过程中最难的一步。在这里花费了一些时间研究Ant如何编译web项目。build.xml文件就是最后使用的脚本编译文件。