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

docker pull store/oracle/serverjre:8 

2.2 获取 Java JRE

docker pull mongo 

3. 构建自定义 Docker 容器

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

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

Dockerfile 的内容如下所示：

# 基础 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 包的同级目录下，示意如下：

之后执行如下命令：

docker build -t ky-server .

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

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

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

4.1 创建 Docker Network

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

docker network create -d bridge bitky

打开两个 Shell，分别执行如下两条指令：

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 即可，本文不再赘述。

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

docker container ls

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

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

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

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 的时区