使用 Docker 部署 Spring Boot 項目，帶勁！！

本文轉載自查看原文 2020-11-25 11:08 6510

Docker 一次構建、處處運行及快速啟停的特性，在微服務架構中有着舉足輕重的地位，具體的概念性的東西就不介紹了，不懂的點擊這里閱讀 Docker 基礎教程。

本篇棧長主要介紹下如何通過 IntelliJ IDEA、Maven 來操作 Docker 部署 Spring Boot 項目，這也是我們 Java 程序員最關心的開發實戰。

一、Maven 插件配置

首先在 Maven pom.xml 配置文件中加入 Docker 的 Maven 插件。

我看網上很多人還在用 docker-maven-plugin 插件：

<properties>
    <docker.image.prefix>docker</docker.image.prefix>
</properties>

<build>
    <plugins>
        <plugin>
            <groupId>com.spotify</groupId>
            <artifactId>docker-maven-plugin</artifactId>
            <version>1.2.2</version>
            <configuration>
                <imageName>${docker.image.prefix}/${project.artifactId}</imageName>
                <dockerDirectory>src/main/docker</dockerDirectory>
                <resources>
                    <resource>
                        <targetPath>/</targetPath>
                        <directory>${project.build.directory}</directory>
                        <include>${project.build.finalName}.jar</include>
                    </resource>
                </resources>
            </configuration>
        </plugin>
    </plugins>
</build>

你們還在用這個插件嗎？

棧長從官方倉庫看到，這個插件官方已經不維護了：

所以這個插件我就不推薦大家使用了，而是推薦官方的另外一個插件：dockerfile-maven。

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

這個插件使用簡單，功能更強大。

新插件地址：

https://github.com/spotify/dockerfile-maven

最新版插件的環境要求：

JDK 7+
Apache Maven 3.5.2+

這個插件的牛逼之處在於：

1、從插件名稱就可以知道，這個插件是基於 Dockerfile 文件進行構建 Docker 項目的，專注 Dockerfile 文件，所以需要一個 Dockerfile 文件，Dockerfile 也是構建 Docker 項目的基石。

2、把 Docker 的構建過程集成到了 Maven 的構建過程之中，如果使用默認的配置，使用 mvn package 命令就能打包成一個 Docker 鏡像，使用 mvn deploy 命令就能推送到 Docker 倉庫。

3、使我們的構建目標更明確，如我們先使用 mvn dockerfile:build 然后再 mvn dockerfile:tag，然后再 mvn dockerfile:push，也可以滿足同時構建再推送的場景，如： mvn dockerfile:build dockerfile:push，這都沒問題的。

4、與 Maven 構建集成，我們可以在一個項目中依賴另外一個項目的 Docker 鏡像，Maven 將以正確的順序構建項目。當我們運行涉及多個服務的集成測試用例時，這很有用的。

二、Docker 配置

Dockerfile 是創建 Docker 鏡像的基本配置文件，本身是一個文本文件。

插件默認加載位置為項目所在根目錄，因為我在上面的 Maven 插件配置中指明了路徑。所以，在 src/main/docker/ 目錄下添加一個 Dockerfile 文件：

# 添加 Java 8 鏡像來源
FROM java:8

# 添加參數
ARG JAR_FILE

# 添加 Spring Boot 包
ADD target/${JAR_FILE} app.jar

# 執行啟動命令
ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/app.jar"]

值得說一下的是，上面的 JAR_FILE 參數就是從 Docker Maven 插件中指定的構建參數，這也是這個插件的強大之處，可以翻到文章上面去看一下。

具體的 Dockerfile 文件細節比較多，這里就不展開詳細介紹了，后面我再開一篇單獨介紹，關注公眾號Java技術棧第一時間推送。

三、添加測試接口

添加一個測試接口，以便后面部署測試。

package cn.javastack.springboot.docker;

import org.springframework.boot.Banner;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.builder.SpringApplicationBuilder;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

/**
 * 微信公眾號：Java技術棧
 */
@RestController
@SpringBootApplication
public class DockerApplication {

    public static void main(String[] args) {
        SpringApplication.run(DockerApplication.class);
    }

    @GetMapping("/docker/hello")
    public String helloDocker() {
        return "hello docker";
    }

}

Spring Boot 基礎性的知識和搭建過程就不介紹了，不熟悉的可以關注公眾號Java技術棧，在后台回復關鍵字 "boot" 閱讀我之前寫的系列教程。

所有 Spring Boot 教程實戰源碼在下面個倉庫：