Spring Boot 應用容器化之 Docker、Gradle
摘要:獲取項目源碼, https://github.com/waylau/docker-demos 中的 samples/spring-boot-gradle。本文演示瞭如何用 Docker、Gradle 來構建、運行、發佈來一個 Spring Boot 應用。
作者:waylau
來源:https://waylau.com/docker-spring-boot-gradle/
本文演示瞭如何用 Docker、Gradle 來構建、運行、發佈來一個 Spring Boot 應用。
Docker 簡介
Docker 是一個 Linux 容器管理工具包,具備“社交”方面,允許用戶發佈容器的 image (鏡像),並使用別人發佈的 image。Docker image 是用於運行容器化進程的方案,在本文中,我們將構建一個簡單的 Spring Boot 應用程序。
有關 Docker 的詳細介紹,可以移步至 《簡述 Docker》
前置條件
- JDK 1.8+
- Gradle 2.3+
- Docker 最新版。有關 Docker 在的安裝,可以參閱 《Docker 在 CentOS 下的安裝、使用》。 如果你的電腦不是 Linux 系統,最好裝個虛擬機,在虛擬機裏面裝個 Linux ,因爲 Docker 的依賴 Linux。
用 Gradle 構建項目
創建目錄結構
項目的目錄結構因符合 Gradle 的約定。
在 *nix 系統下執行 mkdir -p src/main/java/docker_spring_boot ,生產如下結構 :
創建 Gradle 構建文件
Spring Boot gradle plugin 提供了很多方便的功能:
它收集的類路徑上所有 jar 文件,並構建成一個單一的、可運行的“über-jar”(德語,相關解釋可以移步至 http://stackoverflow.com/questions/11947037/what-is-an-uber-jar),這使得它更方便地執行和傳輸服務。
編寫 Spring Boot 應用
編寫一個簡單的 Spring Boot 應用 :
解釋下上面的代碼:
類用 @SpringBootApplication @RestController 標識,可用 Spring MVC 來處理 Web 請求。
@RequestMapping 將 / 映射到 home() ,並將”Hello Docker World” 文本作爲響應。
main() 方法使用 Spring Boot 的 SpringApplication.run() 方法來啓動應用。
運行程序
使用 Gradle
編譯:
gradle build
運行:
java -jar build/libs/docker-spring-boot-gradle-1.0.0.jar
訪問項目
如果程序正確運行,瀏覽器訪問 http://localhost:8080/,可以看到頁面 “Hello Docker World.” 字樣。
將項目容器化
Docker 使用 Dockerfile 文件格式來指定 image 層,
創建文件 src/main/docker/Dockerfile:
FROM frolvlad/alpine-oraclejdk8:slim
VOLUME /tmp
ADD docker-spring-boot-gradle-1.0.0.jar app.jar
ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/app.jar"]
解釋下這個配置文件:
VOLUME 指定了臨時文件目錄爲/tmp。其效果是在主機 /var/lib/docker 目錄下創建了一個臨時文件,並鏈接到容器的/tmp。改步驟是可選的,如果涉及到文件系統的應用就很有必要了。/tmp目錄用來持久化到 Docker 數據文件夾,因爲 Spring Boot 使用的內嵌 Tomcat 容器默認使用/tmp作爲工作目錄
項目的 jar 文件作爲 “app.jar” 添加到容器的
ENTRYPOINT 執行項目 app.jar。爲了縮短 Tomcat 啓動時間,添加一個系統屬性指向 “/dev/urandom” 作爲 Entropy Source
構建 Docker Image
執行構建成爲 docker image:
gradle build buildDocker
運行
運行 Docker Image
訪問項目
如果程序正確運行,瀏覽器訪問 http://localhost:8080/,可以看到頁面 “Hello Docker World.” 字樣。
推送 image 到 Docker Hub
首先,你在 Docker Hub 要有註冊賬號,且創建了相應的庫;
其次,docker 推送前,先要登錄,否則報unauthorized: access to the requested resource is not authorized的錯誤
執行:
docker login
輸出爲:
執行推送
鏡像加速器
Docker Hub 在國外,有時候拉取 Image 極其緩慢,可以使用國內的鏡像來實現加速
阿里雲
echo "DOCKER_OPTS=\"--registry-mirror=https://yourlocation.mirror.aliyuncs.com\"" | sudo tee -a /etc/default/docker
sudo service docker restart
其中 https://yourlocation.mirror.aliyuncs.com 是您在阿里雲註冊後的專屬加速器地址:
DaoCloud
sudo echo “DOCKER_OPTS=\”\$DOCKER_OPTS –registry-mirror=http:
sudo service docker restart
其中 http://your-id.m.daocloud.io 是您在 DaoCloud 註冊後的專屬加速器地址:
源碼
獲取項目源碼, https://github.com/waylau/docker-demos 中的 samples/spring-boot-gradle
獲取項目鏡像, 執行
docker pull waylau/docker-spring-boot-gradle