Jenkins 自动构建部署tomcat项目

Jenkins 是一个开源的、功能强大的应用程序，可持续集成并且持续交付项目。Jenkins自动构建项目的流程原理如下图所示：

用户通过将源码push到svn或者git等仓库上，然后Jenkins会定期pull检查仓库中的源码是否有变化。如发生变化则会重新构建测试项目并打包生成相应的文件存放在指定的目录，这过程中的完成情况可设置以邮件的形式反馈给管理员，并且管理员可登陆到Jenkins上查看相应项目的构建情况。接着项目构建成功后，Jenkins会把相应的项目包推送到指定的服务器上的指定目录下， 然后执行相应的命令进行项目的部署。

接着我们就来看看如何使用Jenkins完成tomcat项目的自动构建部署。

Jenkins的安装可参考： https://www.jianshu.com/p/f2da45e2bac7

在Jenkinsweb界面中的系统管理->系统配置 添加相应的SSH Servers：

如上图所示，添加相应的SSH Server的Ip、用户密码等信息，并设置远程主目录为根目录，也可以配置SSH key 实现免密认证访问。

因为本次实验中我需要构建 https://github.com/charliewch/game-of-life 此项目，因此在构建之前需要保证Jenkins能够连接上GitHub。此实验中，我的Jenkins运行在tomcat应用上，因此其运行用户为tomcat，所以需要使用tomcat用户生成相应的ssh key 然后设置到github 的 setting中。

把上述的id_rsa.pub内容复制粘贴到github的setting中的SSH and GPG keys上：

配置完成后，能够出现下述信息，说明tomcat 用户连接到github已经成功。

在系统管理->系统设置中找到下图的设置，并配置相关的邮件服务器信息

点击新建任务，输入项目名后选择构建一个自由风格的软件项目并确定保存。

在源码管理中添加git作为源码仓库。

设置轮询SCM为每15分钟轮询一次，此处的编写规则遵循crontab 任务的周期编写规则。

在构建增加调用顶层Maven模板的步骤，添加目标为clean package，用于将相应的java项目打包成war包，存放在target目录下。

在构建后的步骤中，新增Editable Email Notification，并在高级中配置触发邮件报警的条件：

此处设置的recipient List 为上一步设置的收件人列表

继续在构建后 *** 作添加步骤：Send build artifacts over SSH

配置完成后点击保存即可

在Gameoflife任务的工作空间中，点击立即构建按钮触发新的构建，点击Build history可查看相应的构建情况：

另外在相应的构建任务中点击查看控制台输出，能够查看构建的结果及相应信息输出，有助于排查错误。

从下图看到，报警邮件也触发成功了。

最后，此时如果用户对修改相应的git仓库的中源码，在下一次git轮询Jenkins会自动触发相应的项目构建并进行推送部署，用户可查看相应的git轮询日志来查看轮询的情况。

1 修改jenkins的根目录，默认地在C:\Documents and Settings\AAA\.jenkins 。

.jenkins

├─jobs

│ └─JavaHelloWorld

│ ├─builds

│ │ ├─2011-11-03_16-48-17

│ │ ├─2011-11-03_16-49-05

│ │ ├─2011-11-03_16-49-29

│ │ ├─2011-11-03_17-01-49

│ │ └─2011-11-03_17-11-42

│ └─workspace

│ ├─build

│ │ ├─classes

│ │ │ └─oata

│ │ └─jar

│ └─src

│ └─oata

├─plugins

├─usercontent

├─war

可以通过设置环境变量来修改，例如：

set JENKINS_HOME=C:\jenkins

然后重新启动jenkins。

2 备份和恢复jenkins

只需要备份JENKINS_HOME下的所有文件和文件夹，恢复的时候需要先停止jenkins。

3 移动，删除或修改jobs

对于移动或删除jobs，只需要简单地移动或删除%JENKINS_HOEM%\jobs目录。

对于修改jobs的名字，只需要简单地修改%JENKINS_HOEM%\jobs下对应job的文件夹的名字。

对于不经常使用的job，只需要对%JENKINS_HOEM%\jobs下对应的jobs的目录zip或tar后存储到其他的地方。

4 可以在jenkins的url中执行一些命令来 *** 作jenkins，如下

http://[jenkins-server]/[command] 命令可以为：

exit shutdown jenkins

restart restart jenkins

reload to reload the configuration

5 Jenkins 启动时的命令行参数

--httpPort=$HTTP_PORT，用来设置jenkins运行时的web端口。

--httpsPort=$HTTP_PORT，表示使用https协议。

--httpListenAddress=$HTTP_HOST，用来指定jenkins监听的ip范围，默认为所有的ip都可以访问此jenkins server。

6 修改jenkins的timezone

如果jenkins所在的server的timezone不同于用户的timezone，这时候需要修改jenkins的timezone，需要在jenkins启动的时候增加下列参数-Dorg.apache.commons.jelly.tags.fmt.timeZone=TZ

7 最好通过一个脚本来启动jenkins，确保jenkins每次都运行在相同的环境下，例如

startjenkins.bat

set JENKINS_HOME=c:\jenkins

cd /d %JENKINS_HOME%

java -jar %JENKINS_HOME%\jenkins.war --httpPort=8000

8 jenkins在后台运行

如果jenkins是部署在servlet容器中，例如apache，tomcat中。因为servlet容器一般都在后台运行了，所以jenkins也就已经在后台运行了。

对于windows用户需要在jenkins的管理页面中点击insall as windows service来将jenkins部署为service。 但是感觉比较好的方法还是手动将启动jenkins的脚本部署为windows service，从而可以更灵活地设置更多的参数。

9 jenkins的系统信息

可以在jenkins的管理页面下的系统信息中，查看所有的jenkins的信息，例如jenkins的启动配置，所依赖的系统的环境变量，所安装的plugins。

10 jenkins内置的环境变量

BUILD_NUMBER， 唯一标识一次build，例如23；

BUILD_ID，基本上等同于BUILD_NUMBER，但是是字符串，例如2011-11-15_16-06-21；

JOB_NAME， job的名字，例如JavaHelloWorld；

BUILD_TAG， 作用同BUILD_ID,BUILD_NUMBER,用来全局地唯一标识一此build，例如jenkins-JavaHelloWorld-23；

EXECUTOR_NUMBER， 例如0；

NODE_NAME，slave的名字，例如MyServer01；

NODE_LABELS，slave的label，标识slave的用处，例如JavaHelloWorld MyServer01；

JAVA_HOME， java的home目录，例如C:\Program Files (x86)\Java\jdk1.7.0_01；

WORKSPACE，job的当前工作目录，例如c:\jenkins\workspace\JavaHelloWorld；

HUDSON_URL = JENKINS_URL， jenkins的url，例如http://localhost:8000/ ；

BUILD_URL，build的url 例如http://localhost:8000/job/JavaHelloWorld/23/；

JOB_URL， job的url，例如http://localhost:8000/job/JavaHelloWorld/；

SVN_REVISION，svn 的revison

---