spring boot 應用釋出到 docker 完整版

一、概述

    spring boot 和 docker 本身就不多介紹了，本文主要介紹使用 docker-maven-plugin 外掛，直接將 spring boot 應用一鍵釋出到 docker 容器中。

    文末會提供原始碼 Git 地址。

    筆者 docker 部署於一臺 Centos 7.2 的雲伺服器，換做 VM 虛擬機器的 Linux 也是一樣的。

    用到的所涉及的軟體版本皆為當前最新的，構建工具為 maven，如果使用的其他工具，請使用對應步驟替換。

二、安裝並配置 Docker

    筆者用於測試的 Linux 為 Centos，其他系統也差不太多。

    1、安裝 Docker

    直接使用 yum 安裝即可：

1. sudo yum install docker

    安裝完成後可以通過如下命令檢視是否安裝成功：

1. docker version

    如果正常輸出版本等相關資訊，即表示安裝成功。

    2、配置 Docker Remote API

    docker-maven-plugin 外掛是使用的 Docker Remote API 進行遠端提交映象的，docker 預設並沒有開啟該選項，直接修改 docker 服務配置即可，

Centos 7 配置檔案位於：/usr/lib/systemd/system/docker.service

    直接在 ExecStart 啟動引數的 /usr/bin/dockerd 後面新增以開啟 TCP 連線：-H tcp://0.0.0.0:2375 -H unix:///var/run/docker.sock

    也可在此增加 Docker Hub 映象加速地址，修改完成後完整的配置如下：

[Unit]
Description=Docker Application Container Engine
Documentation=http://docs.docker.com
After=network.target
Wants=docker-storage-setup.service
Requires=docker-cleanup.timer

[Service]
Type=notify
NotifyAccess=all
KillMode=process
EnvironmentFile=-/etc/sysconfig/docker
EnvironmentFile=-/etc/sysconfig/docker-storage
EnvironmentFile=-/etc/sysconfig/docker-network
Environment=GOTRACEBACK=crash
Environment=DOCKER_HTTP_HOST_COMPAT=1
Environment=PATH=/usr/libexec/docker:/usr/bin:/usr/sbin
ExecStart=/usr/bin/dockerd --registry-mirror=https://registry.docker-cn.com -H tcp://0.0.0.0:2375 -H unix:///var/run/docker.sock \
          --add-runtime docker-runc=/usr/libexec/docker/docker-runc-current \
          --default-runtime=docker-runc \
          --exec-opt native.cgroupdriver=systemd \
          --userland-proxy-path=/usr/libexec/docker/docker-proxy-current \
          $OPTIONS \
          $DOCKER_STORAGE_OPTIONS \
          $DOCKER_NETWORK_OPTIONS \
          $ADD_REGISTRY \
          $BLOCK_REGISTRY \
          $INSECURE_REGISTRY
ExecReload=/bin/kill -s HUP $MAINPID
LimitNOFILE=1048576
LimitNPROC=1048576
LimitCORE=infinity
TimeoutStartSec=0
Restart=on-abnormal
MountFlags=slave

[Install]
WantedBy=multi-user.target
 

    重新載入 systemd，掃描新的或有變動的單元(docker)：

1. systemctl daemon-reload docker

    啟動 docker(如果已啟動，則使用restart)：

1. systemctl start docker

    本地測試：

1. curl http://localhost:2375

    如果沒報錯基本就是完成了。我的工作環境是windows的，沒安裝 curl 工具，直接在瀏覽器輸入 http://ip:2375 也是可以遠端測試的，如果無法訪問，請檢查 docker 所在伺服器的防火牆配置等。

    3、下載父映象

    這一步不是必須的，Docker 會根據 Dockerfile 生成映象時自動下載需要的依賴，但是為了後面完成 Spring boot 應用後構建併發布到 Docker 時不至於傻傻的等，這裡可以先將父映象 pull 到本地。

    java8 執行環境的 docker 映象目前最受歡迎的是 frolvlad/alpine-oraclejdk8 ，那我們就用他吧：

1. docker pull frolvlad/alpine-oraclejdk8

    這可能會耗時一會兒，不過可以放這兒不用管，直接進行下一步。

    通常不指定映象版本，預設會 pull 當期映象的 latest 版本。

三、完成一個 Spring boot 應用並新增 docker-maven-plugin 外掛

    1、完成 Spring boot 應用

    Eclipse 可以安裝 STS 外掛，Idea 也自帶 Spring Boot 工程一鍵生成工具，這裡直接生成一個最簡單的 Web 工程，並在啟動程式碼中加入少許程式碼以對外提供一個簡單的介面用於測試：

1. package com.anxpp.demo;
2. import org.springframework.boot.SpringApplication;
3. import org.springframework.boot.autoconfigure.SpringBootApplication;
4. import org.springframework.web.bind.annotation.RequestMapping;
5. import org.springframework.web.bind.annotation.RestController;
6. @SpringBootApplication
7. @RestController
8. publicclassDockerApplication{
9. publicstaticvoid main(String[] args){
10. SpringApplication.run(DockerApplication.class, args);
11. }
12. @RequestMapping
13. publicString index(){
14. return"Hello world !";
15. }
16. }

    完成後可以執行並訪問 http://localhost:8080 測試是否正常工作。

    2、新增 docker-maven-plugin 外掛

    外掛最新版本為 0.4.13，此處還是貼完整的 pom 檔案吧：

1. <?xml version="1.0" encoding="UTF-8"?>
2. <projectxmlns="http://maven.apache.org/POM/4.0.0"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
3. xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
4. <modelVersion>4.0.0</modelVersion>
5. <groupId>com.anxpp.demo</groupId>
6. <artifactId>docker</artifactId>
7. <version>0.0.1-SNAPSHOT</version>
8. <packaging>jar</packaging>
9. <name>docker</name>
10. <description>Demo project for Spring Boot</description>
11. <parent>
12. <groupId>org.springframework.boot</groupId>
13. <artifactId>spring-boot-starter-parent</artifactId>
14. <version>1.5.4.RELEASE</version>
15. <relativePath/><!-- lookup parent from repository -->
16. </parent>
17. <properties>
18. <docker.image.prefix>anxpp</docker.image.prefix>
19. <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
20. <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
21. <java.version>1.8</java.version>
22. </properties>
23. <dependencies>
24. <dependency>
25. <groupId>org.springframework.boot</groupId>
26. <artifactId>spring-boot-starter-web</artifactId>
27. </dependency>
28. <dependency>
29. <groupId>org.springframework.boot</groupId>
30. <artifactId>spring-boot-starter-test</artifactId>
31. <scope>test</scope>
32. </dependency>
33. </dependencies>
34. <build>
35. <plugins>
36. <plugin>
37. <groupId>org.springframework.boot</groupId>
38. <artifactId>spring-boot-maven-plugin</artifactId>
39. </plugin>
40. <plugin>
41. <groupId>com.spotify</groupId>
42. <artifactId>docker-maven-plugin</artifactId>
43. <version>0.4.13</version>
44. <configuration>
45. <imageName>${docker.image.prefix}/${project.artifactId}</imageName>
46. <dockerHost>http://***.***.anxpp.com:2375</dockerHost>
47. <dockerDirectory>src/main/docker</dockerDirectory>
48. <resources>
49. <resource>
50. <targetPath>/</targetPath>
51. <directory>${project.build.directory}</directory>
52. <include>${project.build.finalName}.jar</include>
53. </resource>
54. </resources>
55. </configuration>
56. </plugin>
57. </plugins>
58. </build>
59. </project>

    imageName 指定生成的映象名稱，dockerHost 指定 Docker Remote API 的遠端訪問地址，這裡請自行按照實際情況填寫。

    3、編寫 Dockerfile

    我們需要在 src/main/docker 下新增 Dockerfile 檔案(當然，這在上一步新增外掛的時候也是可以配置的)，Dockerfile 如何寫請參考 docker 相關文章，文末也會給連線。完整的檔案內容如下：

1. FROM frolvlad/alpine-oraclejdk8
2. VOLUME /tmp
3. ADD docker-0.0.1-SNAPSHOT.jar app.jar
4. RUN sh -c 'touch /app.jar'
5. ENV JAVA_OPTS=""
6. ENTRYPOINT ["sh","-c","java $JAVA_OPTS -Djava.security.egd=file:/dev/./urandom -jar /app.jar"]

    ADD 後面請按照實際情況填寫自己 package 生成的 jar 檔名稱。

四、構建

    1、生成映象

    首先需要執行 maven 的 package 命令生成 jar 檔案，直接執行 docker:build 會因為找不到 jar 檔案而構建失敗！

1. mvn clean package

    現在的 IDE 也都會提供圖形化工具，拖著滑鼠點點點就行了。

    現在回頭看看 二、3 中的父映象有沒有下載好，如果已經下載好即可進行下面的步驟（可以輸入命令檢視映象列表）。

    打包完成後執行 docker:build 。

    如果一切順利，那麼映象就生成好了並推送到 docker 中，輸入如下命令檢視映象列表：

1. docker images

    如果列表中有我們剛剛生成的映象，那麼表示以上步驟都是成功的（廢話）。

    2、執行

    映象執行後就成為容器，使用如下命令執行啟動剛剛生成的映象：

1. docker run -d -p 8080:8080-t anxpp/docker

    -d 是讓容器後臺執行

    -p 是將容器內的埠對映到 docker 所在系統的埠

    -t 是開啟一個偽終端，以便後續可以進入檢視控制檯 log

    檢視執行中的容器：

1. docker ps

    可以使用瀏覽器訪問測試是否一切都很順利：

    http://***.***.anxpp.com:8080

    那麼，用 docker 構建、執行和釋出一個 Spring Boot 應用到此原始碼結束，深藏功與名。

五、多說幾句

    有問題趕緊留言吧，趁我還記得...