Jenkins 自动构建部署tomcat项目

前言

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

image.png

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

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

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

1、添加远程主机的登录密钥（需要安装Publish Over SSH插件）

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

image.png

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

2、Jenkins连接到github（需要安装git、github等插件）

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

[root@node4 ~]# su - tomcat
[tomcat@node4 ~]$ ssh-keygen -t rsa -C "[email protected]"
Generating public/private rsa key pair.
Enter file in which to save the key (/home/tomcat/.ssh/id_rsa): 
Enter passphrase (empty for no passphrase): 
Enter same passphrase again: 
Your identification has been saved in /home/tomcat/.ssh/id_rsa.
Your public key has been saved in /home/tomcat/.ssh/id_rsa.pub.
The key fingerprint is:
SHA256:g54fQr0zQhmH2s94cjoLUG+JJ4bsHkiFzN+lnaYqinQ [email protected]
The key's randomart image is:
+---[RSA 2048]----+
| |
|o . . |
| + .. o.. |
| .oo.=+B. |
| .+.=o@+S |
|.o o Bo= o |
|..oE..B X |
|oo.....O + |
|+ o. oo. |
+----[SHA256]-----+
[tomcat@node4 ~]$ cat .ssh/id_rsa.pub 
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDJsFEJlHLYBqV0aZzp+rpycv9tCDTIBf3slCtjw8127G6uPsm3Cdwm5zsh410kTsZ8AVxonp1XZ2cir4Dh/Pt+D0V9dvZVrFvQqGgYniLU02W+S0JOutxN6fVLSNsHAKpZ6gvvtgvKX5i5shWDH22egb8ImWLZNP3Pf6haxEOi1nj/HOXQeADBf9mW49tqFjllWVhDG/KLF6GNY+sM70l7vDOY2ULuw29QpNmu3QgWDOJ/3vNcU7LwISS16j50a7L85tzlRF63TZ/vxH8vXOONDefd+gg7jyhTI/SQjYifdt1ejtFxByNrNqvWas3rA9puK7GoVuwcgmK7zf1J3JNN [email protected]

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

image.png

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

[tomcat@node4 ~]$ ssh -T [email protected]
Hi charliewch! You've successfully authenticated, but GitHub does not provide shell access.

3、配置SMTP服务器

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

image.png

4、配置Jenkins任务

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

image.png

---

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

image.png

---

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

image.png

---

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

image.png

---

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

image.png

---

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

image.png

---

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

image.png

配置完成后点击保存即可

5、查看构建结果

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

image.png

---

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

image.png

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

image.png

---

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

image.png