说起Docker,大家并不陌生。是目前在开源社区比较火爆的一个东东。它是一个开源的应用引擎,可以为应用系统创建一个可移植的独立的自主容器。容器运行在Linux上,相当于一个虚拟机。但是它与传统的虚拟机有区别。Docker启动速度快,占用资源少,所以非常适合来发布微服务。
如我们的spring boot项目,就十分适合部署在docker上。我想这是未来的一种趋势。
一个周末,终于搞明白了如何在docker上发布spring boot项目。由于本人水平有限,还是折腾了一下,文中描述的都是自己一步一步探索出来,经过验证通过。可能有的比描述的更简便,或者是描述的并不恰当,望大家多多指点一下,让小弟也学习一下,更进一步。谢谢。
- 关于使用spring boot快速构建Restful API接口,在这里不在讲述,spring boot官方文档就是一个很好的例子。
关于Restful API接口的设计指南,下面这篇文章讲解比较好。
http://www.ruanyifeng.com/blog/2014/05/restful_api.html下面我们就开始吧
说明:docker和docker-compose的安装,在此不再讲述,请查阅相关资料。
本次我使用的是安装在VituralBox 中的centos7.2
1、创建Dockerfile
Dockerfile是一个文本文件。
- 登录Linux系统,在根目录创建一个文件夹。
[root@rainbow /]# mkdir web
[root@rainbow /]# cd web/
[root@rainbow web]#
- 创建Dockerfile
[root@rainbow web]# vi Dockerfile
- Dockerfile文件内容如下:
FROM java:8
ADD rainbow-api-user-0.0.1-SNAPSHOT.jar rainbow-api-user.jar
RUN bash -c 'touch /rainbow-api-user.jar'
EXPOSE 8085
ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/rainbow-api-user.jar"]
- 保存退出。
- 关于Dockerfile文件命令请查看相关文档
2、打包、上传spring boot项目的jar文件
- 打包
点击如下图:
- 然后输入命令:
- 说明:关于数据库连接的配置
- 由于我的mongodb数据库是安装在Linux中的,项目部署后,是去访问Linux中的mongodb,虽然docker也是安装在Linux上的,但是数据库连接不能配置为127.0.0.1,因为127.0.0.1是指向docker容器自己。因为Linux与物理机共用IP,所以查看一下宿主机的IP是多少,那就把数据库配置连接中的IP写成多少,如我的宿主机IP是192.168.31.88,那配置如下:
如果配置为127.0.0.1,那从物理机可以访问到Linux中的mongodb,但是如果spring boot部署到docker容器中,就无法访问了,因为127.0.0.1指向的是容器本身。这点我也是踩了个坑。
待项目打包完成后,在项目的target路径下,会有两个jar包,我们需要如下的:
- 上传项目,使用sftp 工具,将jar文件上传到Linux服务器。
我们在刚刚创建的web目录下,再创建一个webapp文件夹,并把Dockerfile文件移动到webapp文件夹下:
[root@rainbow web]# mkdir webapp
[root@rainbow web]# mv Dockerfile webapp/
将jar文件上传到webapp目录下。此时,webpp下有如下两个文件:
现在,我们可以使用docker来构建项目了。由于我们本次的目的是使用docker-compose构建,所以只写出构建命令
在webapp路径下执行:
docker build -t spring .
- 注意:命令最后的那个点,不能少,表示的是当前路径,因为Dockerfile在当前路径下。spring是构建的镜像名,可以自己取。
3、使用docker-compose构建
首先,新建一个docker-compose.yml文件。由于这是个yaml文件,所以格式、缩进很重要。为了不出错,所以在spring boot项目的resources目录下新建一个docker-compose.yml文件,配置好相关项之后,再上传到服务器。内容如下:
spring:
build: ./webapp
ports:
- "80:8085"
这个脚本表示,从当前路径的webapp目录中创建镜像,并将镜像命名为:web,然后使用宿主的80端口映射容器的8085端口。当然,webapp中存放有项目的jar和Dockerfile脚本。
说明:容器的8085端口,因为我自己的项目是跑在8085端口上的,所以要将容器的8085端口映射出来,才能访问。
将docker-compose.yml文件上传到服务器的web目录下:
此时,web的目录结构如下:
最后,我们就可以使用docker-compose up -d 命令来构建运行了。-d表示在后台运行。注意,要在web路径下执行。
构建成功之后,会与如下的提示:
[root@rainbow web]# docker-compose up -d
Building spring
Step 1 : FROM java:8
---> d23bdf5b1b1b
Step 2 : ADD rainbow-api-user-0.0.1-SNAPSHOT.jar rainbow-api-user.jar
---> e2d71b21b18d
Removing intermediate container a67714060589
Step 3 : RUN bash -c 'touch /rainbow-api-user.jar'
---> Running in 80373f7f206f
---> 00e9ab13963d
Removing intermediate container 80373f7f206f
Step 4 : EXPOSE 8085
---> Running in a161e595c79c
---> b77fe6b6f8e3
Removing intermediate container a161e595c79c
Step 5 : ENTRYPOINT java -Djava.security.egd=file:/dev/./urandom -jar /rainbow-api-user.jar
---> Running in e25617bae6a2
---> a5a04f6f82a1
Removing intermediate container e25617bae6a2
Successfully built a5a04f6f82a1
WARNING: Image for service spring was built because it did not already exist. To rebuild this image you must use `docker-compose build` or `docker-compose up --build`.
Creating web_spring_1 ...
Creating web_spring_1 ... done
[root@rainbow web]#
到此,容器已经构建运行完成。spring boot项目已经完成发布了。
查看运行的容器
docker-compose ps
- 可以看到,我们的容器已经正在运行了。
[root@rainbow web]# docker-compose ps
Name Command State Ports
web_spring_1 java -Djava.security.egd=f ... Up 0.0.0.0:80->8085/tcp
[root@rainbow web]#
- 查看容器的日志信息:
docker-compose logs -f [容器名]
docker-compose logs -f spring
- 停止容器
docker-compose stop spring
- 启动容器
docker-compose start spring
- 访问spring boot项目。现在,可以访问容器了。spring boot项目的端口号是8085,我们把容器的8085端口映射到了宿主机的80端口,所以可以直接使用80端口访问项目。
- 如下,可以正常访问,到此,我们的spring boot项目部署成功
4、使用外网能够访问docker容器中的spring boot项目
企业一般应该是使用VPN工具来映射IP地址,然后就可以通过外网访问了。由于我们没有公网IP,所以我在此使用了花生壳这个工具,将宿主机的IP和端口映射到花生壳,就可以使用域名从外网访问docker容器中的spring boot项目了。
- 花生壳的使用不再介绍。
花生壳中有个内网映射功能。映射之前要先开通花生壳的内网穿透功能。我把我宿主机的IP:192.168.31.88,因为spring boot项目的端口是8085,但是经过docker容器映射到了宿主机的80端口,所以我们只需要映射宿主机的80端口即可。
- 使用域名访问docker容器中的spring boot。
到此,spring boot项目在docker容器中的部署已完成。由于本人水平有心,不足支持网大家多多指导一下小弟,谢谢!!