本文旨在通過將一個具體的 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 作為基礎鏡像,經過實驗發現,只需要執行指令的第一句即可。