Java 后端 / 系统课时

构建可执行包与分层镜像

构建可执行包与分层镜像

本课解决 Spring Boot 应用从源码到生产镜像的交付问题,最终能够使用 Maven 生成可执行 JAR,并通过分层机制构建更小、更易缓存的 Docker 镜像。

学习目标

  • 理解 Spring Boot 可执行 JAR 的结构与分层机制
  • 掌握 Maven 打包和 Docker 多阶段构建流程
  • 能够验证镜像内容并优化构建效率

认识可执行包与分层镜像

Spring Boot 应用通常通过可执行 JAR 直接运行,但生产环境还需要考虑镜像体积、构建速度和依赖更新效率。分层 JAR 会把应用内容拆分为多个稳定层,让 Docker 在重新构建时复用没有变化的部分。

典型分层包含依赖、Spring Boot Loader、业务代码和资源文件。依赖变化频率较低,业务代码变化频率较高,将两者分离可以减少重复下载和重新构建。

使用 Maven 生成分层 JAR

Spring Boot 3 项目可以通过 Maven 插件开启分层打包。

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

执行打包命令:

bash
mvn clean package

预期输出

text
BUILD SUCCESS

生成的 JAR 可以通过 java -jar 运行,也可以被 Docker 按层拆解使用。

构建多阶段 Docker 镜像

多阶段构建将编译环境和运行环境分离。第一阶段负责准备应用产物,第二阶段只保留运行所需文件,降低最终镜像大小。

dockerfile
FROM maven:3.9-eclipse-temurin-17 AS builder
WORKDIR /app
COPY . .
RUN mvn clean package -DskipTests

FROM eclipse-temurin:17-jre
WORKDIR /app
COPY --from=builder /app/target/*.jar app.jar
EXPOSE <PORT>
ENTRYPOINT ["java", "-jar", "app.jar"]

构建镜像:

bash
docker build -t spring-app:<ID> .

预期输出

text
Successfully built spring-app:<ID>

验证镜像运行结果

启动容器后,需要确认应用端口监听正常,并检查健康接口或业务接口是否能够访问。

bash
docker run -d -p <PORT>:<PORT> spring-app:<ID>
docker ps

预期结果

text
CONTAINER ID   IMAGE                 STATUS
<ID>           spring-app:<ID>       Up

常见构建问题

如果镜像体积异常增大,应检查是否把源码、构建缓存或开发依赖复制到了运行阶段。如果构建速度变慢,应确认 Dockerfile 是否保持稳定依赖层在前、业务代码层在后。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

构建可执行包与分层镜像

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通