Jenkins+Docker+SpringBoot

背景:

项目采用springboot框架,用gradle构建,版本管理使用git

本文目的:

1 使用Jenkins从git服务器拉取代码并打war包

2 构建后Jenkins通过执行脚本,build出tomcat的docker的镜像并启动应用

步骤:

1 基础环境,jdk,gradle安装省略

2 Docker安装参考官网: docker安装文档

3 Jenkins安装下载 Jenkins官网下载

 Jenkins其实是个web应用, 建议下载war包版本的Jenkis,其他版本的本质上就是war包. war包直接放到宿主机的tomcat等容器中运行即可,如果不想安装tomcat,可以使用jdk自带(jdk7以上)的命令来启动:

java -jar jenkins.war --httpPort=9090 --prefix=/jenkins

以上命令启动后,访问Jenkins地址:http://宿主机IP:9090/jenkins

根据提示输入admin密码,密码查看位置:/用户目录/.jenkins/secrets/initialAdminPassword

输入admin密码后,会提示创建新用户,安装一些插件,可选择前面一个选项,安装一些标准插件(这一步进入Jenkins后也可以自己增加需要的插件)等,按照提示操作即可

4 项目配置

正常的springboot,gradle的工程结构,但是需要在工程根目录增加Dockerfile 文件(无扩展名),提交到git

Dockerfile文件内容如下:

FROM tomcat:8 #使用tomcat 8

MAINTAINER whl

ENV REFRESHED_AT 2017-9-18

RUN rm -rf /usr/local/tomcat/webapps/myproj/* #删除原先部署的文件

COPY build/libs/myproj-0.0.1-SNAPSHOT.war /usr/local/tomcat/webapps/myproj/ #将构建出来的war包复制到部署目录,这里我放在了tomcat的webapps下面 ,因为命令是在jenkins中该项目的工作目录下执行,打包后的文件在build/libs下,因此拷贝使用相对路径即可 ,这里是将宿主机的文件拷贝到容器中

RUN cd /usr/local/tomcat/webapps/myproj ; unzip myproj-0.0.1-SNAPSHOT.war #进入容器的目录,解压war包,个人习惯这种方式

EXPOSE 8080 #暴露8080端口

ENTRYPOINT ["/usr/local/tomcat/bin/catalina.sh", "run" ] #启动tomcat

5 Jenkins配置

登录Jenkins,在上一步安装了标准插件的基础上,进入系统管理->管理插件,安装插件 Hudson Post build task

点击"新建"

选择自由风格项目,输入名称后点击保存

输入git的地址,点击add按钮来添加访问git需要的用户密码信息

在构建标签中选择gralde方式

输入要执行的命令,下图输入war,等于执行 gradle war 命令进行打包

在构建后操作标签中,选择post build task(依赖于上面安装的插件Hudson Post build task)

Logtext 输入见下图,不能输入别的,因为上一步构建成功输出的就是 BUILD SUCCESSFUL

也就是说,这一步依赖于构建是否成功,构建成功才会执行脚本

script中可以直接输入脚本,也可以运行指定的sh脚本,建议将要执行的脚本写到sh文件中,如果将多行脚本直接填写在这里,会出现一行执行失败,就不再执行后续其他脚本的问题

这里我们再build docker image的时候,设置一个我们自己的唯一的tag,比如

docker build -t whl:mytag .  目的是后续停止容器,删除image的时候用grep来查找

网上很多教程都是很暴力的把docker中所有的容器都删除,这个在实际生产中显然是不行的

本例中docker.sh执行的就是docker的相关命令,内容如下:

docker ps -a|grep mytag | awk '{print $1}'|xargs docker kill # kill掉已经启动的这个工程的容器,根据tag来查找,防止误杀其他容器

docker ps -a|grep mytag | awk '{print $1}'|xargs docker rm #删除掉相关容器,也根据tag查找,防止误删其他项目的docker

docker images|grep mytag | awk '{print $3}'|xargs docker rmi #删除已经存在的容器,同样根据我们的tag来查找

docker build -t whl:mytag .  #build新的image,设置为我们自己的唯一tag,注意这行结尾有个"点",表示读取当前目录的Dockerfile,也就是前面我们放在项目根目录的文件

docker run -d -v /resource:/resource  -p 8081:8080 whl:mytag #启动容器,绑定端口,共享需要的目录

点击立即构建后,会出现下图构建进度,点击 15 进去可以看构建过程详情

点击 Console Output,可以看到日志输出

这里输出的 BULD SUCCESSFUL 就是我们构建后执行脚本的前置条件

后续就是执行docker相关的命令输出

成功后打开浏览器访问 http://127.0.0.1:8081/myporj 可以看到你自己的工程启动了.

工程启动过程中有错误就不在本文讨论范围了