本文旨在通过将一个具体的 Spring Boot + MongoDB 项目进行 Docker 化处理,从而对 Docker 的基本用法进行一次实践。该项目 Docker 化后,后端服务访问数据库正常,仍然可以打开后端服务托管的单页 Web 应用,总之项目运行状态符合预期。具体使用的项目见 这个 GitHub 仓库 。
学习 Docker 的基本原理、基本用法可以参考这本开源电子书 《Docker — 从入门到实践》 ,我觉得这本书写的算是目前最好的了,至少比一些同类出版书刊好。
Docker 的基本原理、基本用法均不在这篇文章介绍,想学习 Docker 请参考上面这本开源书,本文进记录一次项目的 Docker 化实践。
在 Docker Store 中,搜索想要获取的 Docker 镜像,然后按照说明获取即可。
docker pull store/oracle/serverjre:8
docker pull mongo
Java 项目构建为 Docker 容器需要如下文件:
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 镜像,如下所示:
随着 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
从图中可以直观看到端口映射状态及容器运行状态。
容器中的默认时区是 UTC,如果要修改自制 Docker 镜像的时区,只需要在 Dockerfile 中加入下面两句就可以了:
RUN echo "Asia/Shanghai" > /etc/timezone RUN dpkg-reconfigure -f noninteractive tzdata
需要注意的是,本文给出的 Dockerfile 已添加了如上的语句,不需要重复添加该语句。 RUN dpkg-reconfigure -f noninteractive tzdata
是 Ubuntu 修改时区的命令。如果你的自定义镜像使用的是其他发行版,那么这里的命令也要改变。本文采用的是 JRE 作为基础镜像,经过实验发现,只需要执行指令的第一句即可。