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 可以看到你自己的工程启动了.
工程启动过程中有错误就不在本文讨论范围了