使用 Docker 部署 Spring Boot

Joe.Ye • 2023-04-01 • Docker, Spring Boot

Docker 技术发展为微服务落地提供了更加便利的环境，使用 Docker 部署 Spring Boot 其实非常简单，首先构建一个简单的 Spring Boot 项目，然后给项目添加 Docker 支持，最后对项目进行部署。

一个简单 Spring Boot 项目

在 pom.xml 中，使用 Spring Boot 2 相关依赖

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.1.3.RELEASE</version>
    <relativePath/> <!-- lookup parent from repository -->
</parent>

添加 web 和测试依赖

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>

    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
    </dependency>
</dependencies>

创建一个 DockerController，在其中有一个index()方法，访问时返回：Hello Docker!

@RestController
public class DockerController {

    @RequestMapping("/")
    public String index() {
        return "Hello Docker!";
    }

}

添加完毕后启动项目，启动成功后浏览器放问：http://localhost:8080/ 页面返回：Hello Docker!，说明 Spring Boot 项目配置正常。

Spring Boot 项目添加 Docker 支持

在 pom.xml 的 properties 中添加 Docker 镜像名称：

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

plugins 中添加 Docker 构建插件：

<plugins>
    <plugin>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
    </plugin>
    <!-- Docker maven plugin -->
    <!-- https://github.com/spotify/docker-maven-plugin -->
    <plugin>
        <groupId>com.spotify</groupId>
        <artifactId>docker-maven-plugin</artifactId>
        <version>1.2.0</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>
    <!-- Docker maven plugin -->
</plugins>

在目录src/main/docker下创建Dockerfile文件，Dockerfile文件用来说明如何来构建镜像

FROM openjdk:8-jdk-alpine
VOLUME /tmp
ADD spring-boot-docker-1.0.jar app.jar
ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/app.jar"]

这个 Dockerfile 文件很简单，构建 Jdk 基础环境，添加 Spring Boot Jar 到镜像中，简单解释一下:

FROM：表示使用 Jdk8 环境为基础镜像，如果镜像不是本地的会从 DockerHub 进行下载
VOLUME：VOLUME指向了一个/tmp的目录，由于Spring Boot使用内置的Tomcat容器，Tomcat 默认使用/tmp作为工作目录。这个命令的效果是：在宿主机的/var/lib/docker目录下创建一个临时文件并把它链接到容器中的/tmp目录
ADD：拷贝文件并且重命名
ENTRYPOINT：为了缩短 Tomcat 的启动时间，添加java.security.egd的系统属性指向/dev/urandom作为ENTRYPOINT

构建打包环境

我们需要有一个 Docker 环境来打包 Spring Boot 项目，以 Centos 7 为例搭建 Docker 环境。

安装 Docker 环境

# yum install docker
# docker -v
# systemctl start docker
# systemctl enable docker

使用Docker中国加速器

# vim /etc/docker/daemon.json
# systemctl restart docker

{
    "registry-mirrors": ["https://registry.docker-cn.com"],
    "live-restore": true
}