Spring Boot项目创建Docker镜像并运行应用

手动创建 Dockerfile

在您的 Spring Boot 项目根目录下创建一个名为 Dockerfile 的文件,并添加以下内容:

FROM eclipse-temurin:21-jre-alpine
COPY target/*.jar app.jar
EXPOSE 8080
ENTRYPOINT ["java","-jar","app.jar"]

如果 target 目录下存在多个 jar 文件,则可以在 dockerfile 同级添加一个 .dockerignore 文件忽略掉 *-sources.jar

# Include any files or directories that you don't want to be copied to your
# container here (e.g., local build artifacts, temporary files, etc.).
#
# For more help, visit the .dockerignore file reference guide at
# https://docs.docker.com/go/build-context-dockerignore/

**/.classpath
**/.dockerignore
**/.env
**/.git
**/.gitignore
**/.project
**/.settings
**/.toolstarget
**/.vs
**/.vscode
**/.next
**/.cache
**/*.*proj.user
**/*.dbmdl
**/*.jfm
**/charts
**/docker-compose*
**/compose.y*ml
**/target/*-sources.jar
**/Dockerfile*
**/node_modules
**/npm-debug.log
**/obj
**/secrets.dev.yaml
**/values.dev.yaml
**/vendor
LICENSE
README.md

在项目根目录下运行以下命令,构建 Docker 镜像:

mvn clean package
docker build -t my-spring-boot-app .

这将先使用 Maven 编译项目,然后使用 Dockerfile 构建名为 my-spring-boot-app 的 Docker 镜像。

使用以下命令启动 Docker 容器:

docker run -p 8080:8080 my-spring-boot-app

使用 Docker init 创建 Dockerfile

参考 Containerize a Java application,首先需要安装 docker desktop,这样才能使用 docker init 命令。

$ docker init
Welcome to the Docker Init CLI!

This utility will walk you through creating the following files with sensible defaults for your project:
  - .dockerignore
  - Dockerfile
  - compose.yaml
  - README.Docker.md

Let's get started!

WARNING: The following Docker files already exist in this directory:
  - docker-compose.yml
? Do you want to overwrite them? Yes
? What application platform does your project use? Java
? What's the relative directory (with a leading .) for your app? ./src
? What version of Java do you want to use? 21
? What port does your server listen on? 8080

生成的 Dockerfile 文件如下:

# syntax=docker/dockerfile:1

# Comments are provided throughout this file to help you get started.
# If you need more help, visit the Dockerfile reference guide at
# https://docs.docker.com/go/dockerfile-reference/

# Want to help us make this template better? Share your feedback here: https://forms.gle/ybq9Krt8jtBL3iCk7

################################################################################

# Create a stage for resolving and downloading dependencies.
FROM eclipse-temurin:21-jdk-jammy as deps

WORKDIR /build

# Copy the mvnw wrapper with executable permissions.
COPY --chmod=0755 mvnw mvnw
COPY .mvn/ .mvn/

# Download dependencies as a separate step to take advantage of Docker's caching.
# Leverage a cache mount to /root/.m2 so that subsequent builds don't have to
# re-download packages.
RUN --mount=type=bind,source=pom.xml,target=pom.xml \
    --mount=type=cache,target=/root/.m2 ./mvnw dependency:go-offline -DskipTests

################################################################################

# Create a stage for building the application based on the stage with downloaded dependencies.
# This Dockerfile is optimized for Java applications that output an uber jar, which includes
# all the dependencies needed to run your app inside a JVM. If your app doesn't output an uber
# jar and instead relies on an application server like Apache Tomcat, you'll need to update this
# stage with the correct filename of your package and update the base image of the "final" stage
# use the relevant app server, e.g., using tomcat (https://hub.docker.com/_/tomcat/) as a base image.
FROM deps as package

WORKDIR /build

COPY ./src src/
RUN --mount=type=bind,source=pom.xml,target=pom.xml \
    --mount=type=cache,target=/root/.m2 \
    ./mvnw package -DskipTests && \
    mv target/$(./mvnw help:evaluate -Dexpression=project.artifactId -q -DforceStdout)-$(./mvnw help:evaluate -Dexpression=project.version -q -DforceStdout).jar target/app.jar

################################################################################

# Create a stage for extracting the application into separate layers.
# Take advantage of Spring Boot's layer tools and Docker's caching by extracting
# the packaged application into separate layers that can be copied into the final stage.
# See Spring's docs for reference:
# https://docs.spring.io/spring-boot/docs/current/reference/html/container-images.html
FROM package as extract

WORKDIR /build

RUN java -Djarmode=tools -jar target/app.jar extract --layers --launcher --destination target/extracted

################################################################################

# Create a new stage for running the application that contains the minimal
# runtime dependencies for the application. This often uses a different base
# image from the install or build stage where the necessary files are copied
# from the install stage.
#
# The example below uses eclipse-turmin's JRE image as the foundation for running the app.
# By specifying the "21-jre-jammy" tag, it will also use whatever happens to be the
# most recent version of that tag when you build your Dockerfile.
# If reproducability is important, consider using a specific digest SHA, like
# eclipse-temurin@sha256:99cede493dfd88720b610eb8077c8688d3cca50003d76d1d539b0efc8cca72b4.
FROM eclipse-temurin:21-jre-jammy AS final

# Create a non-privileged user that the app will run under.
# See https://docs.docker.com/go/dockerfile-user-best-practices/
ARG UID=10001
RUN adduser \
    --disabled-password \
    --gecos "" \
    --home "/nonexistent" \
    --shell "/sbin/nologin" \
    --no-create-home \
    --uid "${UID}" \
    appuser
USER appuser

# Copy the executable from the "package" stage.
COPY --from=extract build/target/extracted/dependencies/ ./
COPY --from=extract build/target/extracted/spring-boot-loader/ ./
COPY --from=extract build/target/extracted/snapshot-dependencies/ ./
COPY --from=extract build/target/extracted/application/ ./

EXPOSE 8080

ENTRYPOINT [ "java", "org.springframework.boot.loader.launch.JarLauncher" ]

注意:

JDK21 使用:

java -Djarmode=tools -jar target/app.jar extract --layers --launcher --destination target/extracted

这个Dockerfile文件是用于构建和运行Java应用程序的Docker镜像。它使用多个阶段(stages)来完成不同的任务。

参考《使用 Docker 容器化并运行 Spring Boot 应用程序》,修改 Dockerfile 后的文件如下:

# syntax=docker/dockerfile:1

# https://docs.docker.com/reference/dockerfile/
# https://docs.docker.com/build/guide/multi-stage/

FROM maven:3-eclipse-temurin-21-alpine AS base
WORKDIR /build
COPY ./src src/
RUN sed -i -E '159a <mirror>\n<id>aliyun</id>\n<name>Aliyun Mirror</name>\n<url>http://maven.aliyun.com/nexus/content/groups/public/</url>\n<mirrorOf>central</mirrorOf>\n</mirror>' /usr/share/maven/conf/settings.xml

FROM base AS test
WORKDIR /build
RUN --mount=type=bind,source=pom.xml,target=pom.xml \
    --mount=type=cache,target=/root/.m2 \
    mvn test

FROM base AS package
WORKDIR /build
RUN --mount=type=bind,source=pom.xml,target=pom.xml \
    --mount=type=cache,target=/root/.m2 \
    mvn package -DskipTests && \
    mv target/$(mvn help:evaluate -Dexpression=project.artifactId -q -DforceStdout)-$(mvn help:evaluate -Dexpression=project.version -q -DforceStdout).jar target/app.jar

FROM package AS extract
WORKDIR /build
RUN java -Djarmode=layertools -jar target/app.jar extract --destination target/extracted

FROM extract AS development
WORKDIR /build
RUN cp -r /build/target/extracted/dependencies/. ./
RUN cp -r /build/target/extracted/spring-boot-loader/. ./
RUN cp -r /build/target/extracted/snapshot-dependencies/. ./
RUN cp -r /build/target/extracted/application/. ./
CMD [ "java", "-Dspring-boot.run.jvmArguments='-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:8000'", "org.springframework.boot.loader.launch.JarLauncher" ]

FROM eclipse-temurin:21-jre-jammy AS final
WORKDIR /app
# See https://docs.docker.com/go/dockerfile-user-best-practices/
ARG UID=10001
RUN adduser \
    --disabled-password \
    --gecos "" \
    --home "/nonexistent" \
    --shell "/sbin/nologin" \
    --no-create-home \
    --uid "${UID}" \
    appuser
USER appuser
COPY --from=extract /build/target/extracted/dependencies/ ./
COPY --from=extract /build/target/extracted/spring-boot-loader/ ./
COPY --from=extract /build/target/extracted/snapshot-dependencies/ ./
COPY --from=extract /build/target/extracted/application/ ./
EXPOSE 8080
ENTRYPOINT [ "java",  "org.springframework.boot.loader.launch.JarLauncher" ]

主要改动:

  • 1、基于 maven:3-eclipse-temurin-21-alpine 镜像构建,并使用阿里云 maven 镜像,使用 mvn 命令,而不是项目中的 mvnw 命令
  • 2、去掉 deps 阶段

使用 Maven 插件

jib-maven-plugin

jib-maven-plugin 是 Google 开发的一款容器镜像构建工具,可以与 Maven 或 Gradle 集成使用。

  1. 在项目的 pom.xml 文件中添加 Jib Maven 插件:
<build>
  <plugins>
    <plugin>
      <groupId>com.google.cloud.tools</groupId>
      <artifactId>jib-maven-plugin</artifactId>
      <version>3.4.4</version>
      <configuration>
        <from>
            <image>eclipse-temurin:21-jre-jammy</image>
        </from>
        <to>
            <image>chensoul/${project.artifactId}</image>
            <tags>
                <tag>latest</tag>
                <tag>${project.version}</tag>
            </tags>
        </to>
      </configuration>
    </plugin>
  </plugins>
</build>
  1. 如果使用 Gradle,在 build.gradle 文件中添加 Jib Gradle 插件:
plugins {
    id 'com.google.cloud.tools.jib' version '3.4.4'
}

jib {
    from {
        image = 'eclipse-temurin:21-jre-jammy'
    }
    to {
        image = 'my-spring-boot-app'
        tags = ['latest', project.version]
    }
    container {
        mainClass = 'com.example.MySpringBootApp'
        ports = ['8080']
    }
}
  1. 运行构建命令:
  • 对于 Maven 项目:mvn compile jib:build
  • 对于 Gradle 项目:./gradlew jibBuild

docker-maven-plugin

  1. 在 pom.xml 中添加如下配置:
<plugin>
    <groupId>io.fabric8</groupId>
    <artifactId>docker-maven-plugin</artifactId>
    <version>0.43.4</version>
    <configuration>
        <verbose>true</verbose>
        <images>
            <image>
                <name>spring-fabric8</name>
                <build>
                    <from>eclipse-temurin:21-jre-jammy</from>
                    <assembly>
                        <descriptorRef>artifact</descriptorRef>
                    </assembly>
                    <entryPoint>
                      <exec>
                        <arg>java</arg>
                        <arg>-jar</arg>
                        <arg>/maven/${project.build.finalName}.${project.packaging}</arg>
                      </exec>
                    </entryPoint>
                </build>
                <run>
                    <ports>
                        <port>8080:8080</port>
                    </ports>
                </run>
            </image>
        </images>
    </configuration>
</plugin>
  1. 运行 mvn docker:build 命令构建镜像。

Spotify Docker Maven Plugin

  1. 在 pom.xml 中添加如下配置:
<build>
    <plugins>
        <plugin>
            <groupId>com.spotify</groupId>
            <artifactId>dockerfile-maven-plugin</artifactId>
            <version>1.4.13</version>
            <configuration>
                <repository>my-spring-boot-app</repository>
                <tag>${project.version}</tag>
                <buildArgs>
                    <JAR_FILE>${project.build.finalName}.jar</JAR_FILE>
                </buildArgs>
            </configuration>
        </plugin>
    </plugins>
</build>
  1. 运行 mvn dockerfile:build 命令构建镜像。

kubernetes-maven-plugin

<plugin>
    <groupId>org.eclipse.jkube</groupId>
    <artifactId>kubernetes-maven-plugin</artifactId>
    <version>1.17.0</version>
    <configuration>
        <images>
            <image>
                <alias>${project.artifactId}</alias>
                <name>chensoul/${project.artifactId}:latest</name>
                <build>
                    <from>openjdk:21</from>
                    <assembly>
                        <mode>dir</mode>
                        <targetDir>/usr/home/app</targetDir>
                        <inline>
                            <id>copy-jar</id>
                            <baseDirectory>/home/home/app</baseDirectory>
                            <files>
                                <file>
                                    <source>target/${project.artifactId}-${project.version}.jar</source>
                                    <outputDirectory>.</outputDirectory>
                                </file>
                            </files>
                        </inline>
                    </assembly>
                    <workdir>/usr/home/app</workdir>
                    <cmd>java -jar ${project.artifactId}-${project.version}.jar</cmd>
                    <ports>
                        <port>8080</port>
                    </ports>
                </build>
            </image>
        </images>
    </configuration>
    <executions>
        <execution>
            <id>goals</id>
            <goals>
                <goal>resource</goal>
                <!--goal>helm</goal-->
                <!--goal>build</goal-->
                <!--goal>deploy</goal-->
            </goals>
        </execution>
    </executions>
</plugin>

exec-maven-plugin

参考 spring-petclinic-microservices 项目:

<properties>
    <docker.image.prefix>springcommunity</docker.image.prefix>
    <docker.image.exposed.port>9090</docker.image.exposed.port>
    <docker.image.dockerfile.dir>${basedir}</docker.image.dockerfile.dir>
    <!-- podman is also supported -->
    <container.executable>docker</container.executable>
    <!-- By default, the OCI image is build for the linux/amd64 platform -->
    <!-- For Apple Silicon M2 Chip you have to change it to the linux/arm64 -->
    <container.platform>linux/amd64</container.platform>
    <!-- The -load option is a shortcut for or -output=type=docker -->
    <!-- Could be changed by the -push option !-->
    <container.build.extraarg>--load</container.build.extraarg>
</properties>
<plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>exec-maven-plugin</artifactId>
    <version>3.1.1</version>
    <executions>
        <execution>
            <id>docker-build</id>
            <phase>install</phase>
            <goals>
                <goal>exec</goal>
            </goals>
            <configuration>
                <executable>${container.executable}</executable>
                <workingDirectory>${docker.image.dockerfile.dir}</workingDirectory>
                <arguments>
                    <argument>build</argument>
                    <argument>-f</argument>
                    <argument>Dockerfile</argument>
                    <argument>--build-arg</argument>
                    <argument>ARTIFACT_NAME=${project.build.finalName}</argument>
                    <argument>--build-arg</argument>
                    <argument>EXPOSED_PORT=${docker.image.exposed.port}</argument>
                    <argument>--platform</argument>
                    <argument>${container.platform}</argument>
                    <argument>${container.build.extraarg}</argument>
                    <argument>-t</argument>
                    <argument>${docker.image.prefix}/${project.artifactId}</argument>
                    <argument>${project.build.directory}</argument>
                </arguments>
            </configuration>
        </execution>
    </executions>
</plugin>

使用 Spring Boot Maven 插件

使用 Buildpacks

Spring Boot在2.3.0之后,引入了Cloud Native 的buildpacks,通过这个工具,我们可以非常非常方便的创建docker image。

在Maven和Gradle中,Spring Boot引入了新的phase: spring-boot:build-image

使用 Buildpacks 构建镜像:

  • Buildpacks 是一种自动化的构建过程,可以根据应用程序源码生成 Docker 镜像。
  • 可以使用 Cloud Native Buildpacks 或 Heroku Buildpacks 来构建 Spring Boot 应用的 Docker 镜像。
  • 运行 pack build my-spring-boot-app --builder gcr.io/buildpacks/builder:v1 即可构建镜像。
  1. 在项目的 pom.xml 文件中添加 spring-boot-maven-plugin 插件配置。
<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
        <image>
            <name>chensoul/${project.artifactId}</name>

            <env>
                <!-- Make sure `mvn spring-boot:build-image` uses the Java version defined in this project -->
                <BP_JVM_VERSION>${java.version}</BP_JVM_VERSION>
            </env>
        </image>
        <docker>
            <publishRegistry>
                <username>${docker.publishRegistry.username}</username>
                <password>${docker.publishRegistry.password}</password>
            </publishRegistry>
        </docker>
    </configuration>
</plugin>
  1. 构建镜像
mvn spring-boot:build-image -DskipTests
  1. 或者构建镜像并上传到 docker hub
mvn spring-boot:build-image -DskipTests \
  -Ddocker.publishRegistry.username=user \
  -Ddocker.publishRegistry.password=secret \
  -Dspring-boot.build-image.publish=true

使用 Layered Jar

如果你不想使用Cloud Native Buildpacks,还是想使用传统的Dockerfile。 没关系,SpringBoot为我们提供了独特的分层jar包系统。

怎么开启呢? 我们需要在POM文件中加上下面的配置:

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <configuration>
                <layers>
                    <enabled>true</enabled>
                </layers>
            </configuration>
        </plugin>
    </plugins>
</build>

使用 layer 之后,Spring 官方文档中提供dockerfile如下:

FROM bellsoft/liberica-runtime-container:jre-17-cds-slim-glibc as builder
WORKDIR /builder
ARG JAR_FILE=target/*.jar
COPY ${JAR_FILE} application.jar
RUN java -Djarmode=tools -jar application.jar extract --layers --destination extracted

FROM bellsoft/liberica-runtime-container:jre-17-cds-slim-glibc
WORKDIR /application
COPY --from=builder /builder/extracted/dependencies/ ./
COPY --from=builder /builder/extracted/spring-boot-loader/ ./
COPY --from=builder /builder/extracted/snapshot-dependencies/ ./
COPY --from=builder /builder/extracted/application/ ./
ENTRYPOINT ["java", "-jar", "application.jar"]

使用 Spring Boot Gradle 插件

  • 在项目的 build.gradle 文件中添加 spring-boot-gradle-plugin 插件配置。
  • 插件会自动生成 Dockerfile 并构建 Docker 镜像。
  • 使用 ./gradlew bootBuildImage 命令即可构建并推送镜像。

使用 Maven 镜像从源码运行

使用 dockerfile

参考 《Build a Docker Image using Maven and Spring boot》不使用分层构建:

# Use an official Maven image as the base image
FROM maven:3.8.4-openjdk-11-slim AS build
# Set the working directory in the container
WORKDIR /app
# Copy the pom.xml and the project files to the container
COPY pom.xml .
COPY src ./src
# Build the application using Maven
RUN mvn clean package -DskipTests

# Use an official OpenJDK image as the base image
FROM openjdk:11-jre-slim
# Set the working directory in the container
WORKDIR /app
# Copy the built JAR file from the previous stage to the container
COPY --from=build /app/target/my-application.jar .
# Set the command to run the application
CMD ["java", "-jar", "my-application.jar"]

结合前面的分层构建镜像,一个简单版本的 dockerfile 如下:

FROM maven:3-eclipse-temurin-21-alpine AS package
WORKDIR /build
COPY . .
RUN mvn package -DskipTests && \
    mv target/*.jar target/app.jar

FROM package AS extract
WORKDIR /build 
RUN java -Djarmode=tools -jar app.jar target/extract --layers --launcher --destination target/extracted

FROM eclipse-temurin:21-jre-jammy AS final
WORKDIR /app
COPY --from=extract /build/target/extracted/dependencies/ ./
COPY --from=extract /build/target/extracted/spring-boot-loader/ ./
COPY --from=extract /build/target/extracted/snapshot-dependencies/ ./
COPY --from=extract /build/target/extracted/application/ ./
EXPOSE 8080
ENTRYPOINT [ "java",  "org.springframework.boot.loader.launch.JarLauncher" ]

复杂一点的 dockerfile 如下:

# syntax=docker/dockerfile:1

# https://docs.docker.com/reference/dockerfile/
# https://docs.docker.com/build/guide/multi-stage/

FROM maven:3-eclipse-temurin-21-alpine AS base
WORKDIR /build
COPY ./src src/
RUN sed -i -E '159a <mirror>\n<id>aliyun</id>\n<name>Aliyun Mirror</name>\n<url>http://maven.aliyun.com/nexus/content/groups/public/</url>\n<mirrorOf>central</mirrorOf>\n</mirror>' /usr/share/maven/conf/settings.xml

FROM base AS package
WORKDIR /build
RUN --mount=type=bind,source=pom.xml,target=pom.xml \
    --mount=type=cache,target=/root/.m2 \
    mvn package -DskipTests && \
    mv target/$(mvn help:evaluate -Dexpression=project.artifactId -q -DforceStdout)-$(mvn help:evaluate -Dexpression=project.version -q -DforceStdout).jar target/app.jar

FROM package AS extract
WORKDIR /build
RUN java -Djarmode=layertools -jar target/app.jar extract --destination target/extracted

FROM eclipse-temurin:21-jre-jammy AS final
WORKDIR /app
# See https://docs.docker.com/go/dockerfile-user-best-practices/
ARG UID=10001
RUN adduser \
    --disabled-password \
    --gecos "" \
    --home "/nonexistent" \
    --shell "/sbin/nologin" \
    --no-create-home \
    --uid "${UID}" \
    appuser
USER appuser
COPY --from=extract /build/target/extracted/dependencies/ ./
COPY --from=extract /build/target/extracted/spring-boot-loader/ ./
COPY --from=extract /build/target/extracted/snapshot-dependencies/ ./
COPY --from=extract /build/target/extracted/application/ ./
EXPOSE 8080
ENTRYPOINT [ "java",  "org.springframework.boot.loader.launch.JarLauncher" ]

使用 docker-compose

  1. 在项目根目录创建一个 docker-compose.yml文件:
services:
  app:
    image: maven:3.9.6-eclipse-temurin-21
    volumes:
      - .:/usr/src/workdir
      - ~/.m2:/root/.m2
    working_dir: /usr/src/workdir
    command: "mvn clean -DskipTests spring-boot:run"
    healthcheck:
      test: [ 'CMD-SHELL','curl --fail --silent localhost:8080/actuator/health | grep UP || exit 1' ]
      interval: 5s
      timeout: 5s
      retries: 10
      start_period: 30s
  1. 启动容器
docker-compose app -f docker-compose.yml up -d

参考文章

Share this post:

Related content