Spring Boot + MongoDB 應用的 Docker 化實踐

雪中亮發表於2018-06-05

本文旨在通過將一個具體的 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 映象,然後按照說明獲取即可。

從 Docker Store 中獲取官方映象

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 包的同級目錄下,示意如下:

Java 伺服器目錄

之後執行如下命令:

docker build -t ky-server .
複製程式碼

即可開始構建 Java 服務端應用的 Docker 映象,生成的映象命名為「ky-server」。

Java 服務端應用的 Docker 映象構建完成後,執行 docker images 命令,即可獲取本機儲存的所有 Docker 映象,如下所示:

本機的四個 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
複製程式碼

從圖中可以直觀看到埠對映狀態及容器執行狀態。

Docker 容器執行狀態

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 的時區

相關文章