1. 程式人生 > >跟我學SpringCloud | 第十九章:Spring Cloud 元件 Docker 化

跟我學SpringCloud | 第十九章:Spring Cloud 元件 Docker 化

前面的文章《跟我學SpringCloud | 第十八篇:微服務 Docker 化之基礎環境》我們介紹了基礎環境系統和 JRE 的容器化,這一節我們介紹 Spring Cloud 元件的容器化,主要包括 eureka-server 、 gateway-server 和 provider-server 。

1. Docker 化配置

這裡我們根據 dockerfile-maven-plugin 這個 maven 外掛來構建,可以用來構建 docker 映象的 maven 外掛有很多,其中使用比較多的包括 docker-maven-plugin ,這兩個外掛是同一個人在 Github 上開源的, docker-maven-plugin 被作者標記為不活躍的,並且建議大家使用 dockerfile-maven-plugin ,作者可能是覺得 docker-maven-plugin 在使用的方式上並不是那麼的優雅,才又新寫了 dockerfile-maven-plugin ,具體資訊可以訪問 docker-maven-plugin 在 Github 上的官方倉庫(https://github.com/spotify/docker-maven-plugin)。

本篇文章我們將介紹如何在 IDE 工具 idea 中使用 Docker 工具,併為我們的工程構建映象。

2. 實戰

2.1 建立父工程 chapter18

父工程 pom.xml 依賴檔案:

程式碼清單:chapter18/pom.xml
***

<build>
    <plugins>
        <plugin>
            <groupId>com.spotify</groupId>
            <artifactId>dockerfile-maven-plugin</artifactId>
            <version>${dockerfile.maven.version}</version>
            <executions>
                <execution>
                    <id>default</id>
                    <goals>
                        <goal>build</goal>
                        <goal>push</goal>
                    </goals>
                </execution>
            </executions>
            <configuration>
                <repository>${docker.image.prefix}/${project.artifactId}</repository>
                <tag>${project.version}</tag>
                <buildArgs>
                    <JAR_FILE>${project.build.finalName}.jar</JAR_FILE>
                </buildArgs>
            </configuration>
        </plugin>
    </plugins>
</build>

這裡筆者僅截取了 dockerfile-maven-plugin 相關的程式碼,其餘程式碼可參考 Github 倉庫。

  • 版本筆者這裡選擇的是 v1.4.12 ,也是目前官方倉庫上最新的版本,此版本於 2019年7月30日 釋出。
  • <configuration> 標籤中是一些有關於 Docker 映象相關的配置,包括當前的 <repository><tag> 。但是經筆者測試,如果使用 idea 生成遠端映象(本地無Docker服務),這兩個部分還是會為 null 的,生成完後需要使用命令 docker tag [imageId] [repository]:[tag]
    來重新命名映象。如果本地有 Docker 服務,則無此問題。

2.2 建立子工程 eureka-server

2.2.1 子工程依賴 pom.xml 如下:

程式碼清單:chapter18/eureka_server/pom.xml
***

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
        <plugin>
            <groupId>com.spotify</groupId>
            <artifactId>dockerfile-maven-plugin</artifactId>
        </plugin>
    </plugins>
</build>

由於在父工程中已經詳細配置相關內容,這裡僅需要將 dockerfile-maven-plugin 引入即可。

2.2.2 子工程Dockerfile 如下:

程式碼清單:chapter18/eureka_server/Dockerfile
***

FROM registry.cn-shanghai.aliyuncs.com/springcloud-book/java:8u221-jre
ARG JAR_FILE
ENV PROFILE default
ADD target/${JAR_FILE} /opt/app.jar
EXPOSE 8080
ENTRYPOINT java ${JAVA_OPTS} -Djava.security.egd=file:/dev/./urandom -Duser.timezone=Asia/Shanghai -Dfile.encoding=UTF-8 -Dspring.profiles.active=${PROFILE} -jar /opt/app.jar
  • 這裡使用了我們在前一篇文章《跟我學SpringCloud | 第十八篇:微服務 Docker 化之基礎環境》建立的 registry.cn-shanghai.aliyuncs.com/springcloud-book/java:8u221-jre 映象。
  • 這裡的 JAR_FILE 是我們在父工程的 pom.xml 中配置的引數,作用是指明瞭我們所需要打成映象的 jar 的名稱,我們在父工程的配置內容為 ${project.build.finalName}.jar
  • 埠號這裡統一的指定為 8080 ,最後映射出來的埠號可以根據每個不同的應用進行修改。
  • 這裡統一指定了時區為 Asia/Shanghai ,如果不做指定,可能預設時區不是中國的時區,這裡一定要注意
  • 暴露了 JAVA_OPTS 環境變數,允許不同的應用去指定不同的 jvm 引數。
  • 暴露了 PROFILE 環境變數,允許不同的應用去指定不同的 profile。

2.2.3 子工程配置檔案 application.yml 如下:

程式碼清單:chapter18/eureka_server/src/main/resources/application.yml
***

server:
  port: 8080
spring:
  application:
    name: spring-cloud-eureka-server
  cloud:
    inetutils:
      use-only-site-local-interfaces: true
eureka:
  instance:
    prefer-ip-address: true
    lease-expiration-duration-in-seconds: 90
    lease-renewal-interval-in-seconds: 30
  server:
    enable-self-preservation: false
    eviction-interval-timer-in-ms: 60000
  client:
    register-with-eureka: false
    service-url:
      defaultZone: http://${EUREKA_SERVER_HOST}:${EUREKA_SERVER_PORT}/eureka/
management:
  endpoints:
    web:
      exposure:
        include: '*'
  • 在配置檔案中,我們留出兩個環境變數 EUREKA_SERVER_HOSTEUREKA_SERVER_PORT ,不同的應用可以通過啟動命令來進行配置。

2.2.4 子工程構建 Docker 映象

其餘部分程式碼筆者這裡就不列出了,有需要的朋友請參考 Github 倉庫,接下來嘗試打包映象,這裡我們直接使用 idea 的 package 命令,也可以在工程的跟目錄下執行命令:

mvn clean package

執行以上命令需本地配置 maven 環境變數,否則會報錯 mvn 命令找不到。筆者使用 idea 提供的 package 命令,具體操作如圖:

直接雙擊,可以看到控制檯開始執行打包命令,在打包完成後會將 target/${project.build.finalName}.jar 打包成 Docker 映象,我們可以看到控制檯輸出的命令:

[INFO] Image will be built as registry.cn-shanghai.aliyuncs.com/springcloud-book/eureka_server:0.0.1-SNAPSHOT
[INFO] 
[INFO] Step 1/6 : FROM registry.cn-shanghai.aliyuncs.com/springcloud-book/java:8u221-jre
[INFO] 
[INFO] Pulling from springcloud-book/java
[INFO] Image 9d48c3bd43c5: Already exists
[INFO] Image 828e49a80267: Already exists
[INFO] Image 00b99dcc31ec: Already exists
[INFO] Image e6e45bfebaec: Already exists
[INFO] Digest: sha256:32d9a2557298d7b56997ded086baf043145ca178b71f6c8f47e76f837614bda0
[INFO] Status: Downloaded newer image for registry.cn-shanghai.aliyuncs.com/springcloud-book/java:8u221-jre
[INFO]  ---> 5f59ebcc4b59
[INFO] Step 2/6 : ARG JAR_FILE
[INFO] 
[INFO]  ---> Running in 8e3e51705681
[INFO] Removing intermediate container 8e3e51705681
[INFO]  ---> 0bcb834dc28b
[INFO] Step 3/6 : ENV PROFILE default
[INFO] 
[INFO]  ---> Running in 4a8e840e7a95
[INFO] Removing intermediate container 4a8e840e7a95
[INFO]  ---> 11f97aef63ee
[INFO] Step 4/6 : ADD target/${JAR_FILE} /opt/app.jar
[INFO] 
[INFO]  ---> 61c0ff0c5b6e
[INFO] Step 5/6 : EXPOSE 8080
[INFO] 
[INFO]  ---> Running in 264bf0d042b6
[INFO] Removing intermediate container 264bf0d042b6
[INFO]  ---> d951ab655bd5
[INFO] Step 6/6 : ENTRYPOINT java ${JAVA_OPTS} -Djava.security.egd=file:/dev/./urandom -Duser.timezone=Asia/Shanghai -Dfile.encoding=UTF-8 -Dspring.profiles.active=${PROFILE} -jar /opt/app.jar
[INFO] 
[INFO]  ---> Running in 4bd69be29edc
[INFO] Removing intermediate container 4bd69be29edc
[INFO]  ---> 704768c9dd75
[INFO] Successfully built 704768c9dd75
[INFO] Successfully tagged registry.cn-shanghai.aliyuncs.com/springcloud-book/eureka_server:0.0.1-SNAPSHOT
[INFO] 
[INFO] Detected build of image with id 704768c9dd75
[INFO] Building jar: D:\Development\SpringCloudLearning\chapter18\eureka_server\target\eureka_server-0.0.1-SNAPSHOT-docker-info.jar
[INFO] Successfully built registry.cn-shanghai.aliyuncs.com/springcloud-book/eureka_server:0.0.1-SNAPSHOT
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  01:38 min
[INFO] Finished at: 2019-09-21T20:05:50+08:00
[INFO] ------------------------------------------------------------------------

從以上命令,我們可以看到映象每一步的構建過程,同樣,這個映象筆者這裡 push 到阿里雲的映象倉庫,有需要的朋友可以直接 pull 後使用。

docker pull registry.cn-shanghai.aliyuncs.com/springcloud-book/eureka_server:0.0.1-SNAPSHOT

2.2.5 子工程測試:

測試這裡筆者啟動兩個映象,構建兩個 eureka_server 服務,對外對映分別使用不同的埠, 8761 和 8762 ,命令如下:

docker run -p 8761:8080 --rm \
-e JAVA_OPTS='-server -Xmx1g' \
-e PROFILE='default' \
-e EUREKA_SERVER_HOST=192.168.0.128 \
-e EUREKA_SERVER_PORT=8762 \
registry.cn-shanghai.aliyuncs.com/springcloud-book/eureka_server:0.0.1-SNAPSHOT
docker run -p 8762:8080 --rm \
-e JAVA_OPTS='-server -Xmx1g' \
-e PROFILE='default' \
-e EUREKA_SERVER_HOST=192.168.0.128 \
-e EUREKA_SERVER_PORT=8761 \
registry.cn-shanghai.aliyuncs.com/springcloud-book/eureka_server:0.0.1-SNAPSHOT

啟動成功後開啟瀏覽器分別訪問路徑:http://localhost:8761/ 、 http://localhost:8762/ ,結果如圖:

3. 小結

還有其餘兩個工程 provider_server 和 gateway_server 筆者這裡就不做演示了,相關 Dockerfile 和執行所使用的命令都已經上傳至 Github 倉庫,有需要的讀者可以直接訪問 Github 倉庫獲取。

4. 例項程式碼

示例程式碼-Github

示例程式碼-Gi