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 是否保持稳定依赖层在前、业务代码层在后。
按自己的节奏,确认真正理解。