Spring Boot + MongoDB 应用的 Docker 化实践

本文旨在通过将一个具体的 Spring Boot + MongoDB 项目进行 Docker 化处理,从而对 Docker 的基本用法进行一次实践。该项目 Docker 化后,后端服务访问数据库正常,仍然可以打开后端服务托管的单页 Web 应用,总之项目运行状态符合预期。具体使用的项目见 这个 GitHub 仓库

学习 Docker 的基本原理、基本用法可以参考这本开源电子书《Docker — 从入门到实践》,我觉得这本书写的算是目前最好的了,至少比一些同类出版书刊好。

Docker 的基本原理、基本用法均不在这篇文章介绍,想学习 Docker 请参考上面这本开源书,本文进记录一次项目的 Docker 化实践。

1. 环境准备

  • java: JDK 1.8
  • Linux: Ubuntu 17.10.1
  • Docker CE: 17.12.0

2. 官方 Docker 镜像的获取

在 Docker Store 中,搜索想要获取的 Docker 镜像,然后按照说明获取即可。

2.1 获取 Java JRE

1
docker pull store/oracle/serverjre:8 

2.2 获取 Java JRE

1
docker pull mongo 

3. 构建自定义 Docker 容器

Java 项目构建为 Docker 容器需要如下文件:

  • Jar 文件
  • 本地配置文件
  • Dockerfile 文件

Dockerfile 的内容如下所示:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# 基础 JRE 镜像
FROM store/oracle/serverjre:8

# 修改时区,使得容器时间为北京时间
RUN echo "Asia/Shanghai" > /etc/timezone

# 将所需项目文件复制进入容器中
WORKDIR /app
ADD ./ClusterDevicePlatform-server-1.8.9-release.jar /app
ADD ./setting /app

# 暴露容器的端口
EXPOSE 30232 8080

# 运行项目
CMD ["java", "-jar", "-Dfile.encoding=UTF-8", "ClusterDevicePlatform-server-1.8.9-release.jar"]

Dockerfile 文件编写完成后,该 Java 服务器目录下会有三个文件,其中 setting 文件和 Jar 包为原始项目的组成部分,需配套使用,setting 必须放在 Jar 包的同级目录下,示意如下:

之后执行如下命令:

1
docker build -t ky-server .

即可开始构建 Java 服务端应用的 Docker 镜像,生成的镜像命名为「ky-server」。

Java 服务端应用的 Docker 镜像构建完成后,执行 docker images 命令,即可获取本机保存的所有 Docker 镜像,如下所示:

4. 运行已容器化的 Java 服务端应用

4.1 创建 Docker Network

随着 Docker 网络的完善,官方建议将容器加入自定义的 Docker 网络来连接多个容器,下面先创建一个新的 Docker 网络,并命名为 bitky

1
docker network create -d bridge bitky

打开两个 Shell,分别执行如下两条指令:

1
2
3
docker run --rm --name kylinked-mongo  -p 27017:27017 --network bitky mongo:latest

docker run --rm --name kylinked-server -p 80:8080 -p 30232:30232 --network bitky ky-server:latest

即可分别打开在两个 Shell 前台打开 MongoDB 和 Java 服务端应用,其中 MongoDB 容器的 27017 映射到了操作系统的同名端口,Java 服务器的 8080 端口映射到了操作系统的 80 端口,方便浏览器访问。MongoDB 镜像直接通过常规方式 pull 即可,本文不再赘述。

打开一个新的终端查看容器的状态信息:

1
docker container ls

从图中可以直观看到端口映射状态及容器运行状态。

4.2 Docker 中设置时区为东八区「北京时间」

容器中的默认时区是 UTC,如果要修改自制 Docker 镜像的时区,只需要在 Dockerfile 中加入下面两句就可以了:

1
2
RUN echo "Asia/Shanghai" > /etc/timezone
RUN dpkg-reconfigure -f noninteractive tzdata

需要注意的是,本文给出的 Dockerfile 已添加了如上的语句,不需要重复添加该语句。 RUN dpkg-reconfigure -f noninteractive tzdata 是 Ubuntu 修改时区的命令。如果你的自定义镜像使用的是其他发行版,那么这里的命令也要改变。本文采用的是 JRE 作为基础镜像,经过实验发现,只需要执行指令的第一句即可。

参考链接

  1. Docker Documentation
  2. Docker 部署 SpringBoot 项目整合 Redis 镜像做访问计数 Demo
  3. Spring Boot 应用发布到 Docker
  4. 一步步带你构建 Spring Boot + Docker 应用
  5. Docker 中如何设置 container 的时区