一、概述
spring boot 2.3 开始spring-boot-maven-plugin
插件默认开启了分层构建 jar 包
或者 war 包
,本文次要依据官网文档记录一下如何应用分层 jar 构建镜像。
二、spring-boot-maven-plugin
分层构建 jar 包
配置 spring boot 我的项目继承自 spring-boot-starter-parent
,设置 <parent>
如下:
<!-- Inherit defaults from Spring Boot -->
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.5.1</version>
</parent>
继承自 spring-boot-starter-parent
的我的项目有如下的默认配置:
- 默认编译 jdk:JDK 1.8
- 默认编码:UTF-8
- 默认依赖项治理局部继承自
spring-boot-dependencies POM
,治理公共依赖项的版本,这种依赖治理容许您在本人的 POM 中应用时省略那些依赖项的<version>
标记 - 默认配置的 excution goal 为:
repackage
当在我的项目中引入 spring-boot-maven-plugin
插件默认就开启了分层构建 jar 包
,咱们能够应用如下形式进行验证:
-
在我的项目的 pom.xml 文件中增加如下插件配置:
<project> <modelVersion>4.0.0</modelVersion> <artifactId>getting-started</artifactId> <!-- ... --> <build> <plugins> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> </plugin> </plugins> </build> </project>
-
执行如下命令进行打包:
mvn clean package
在 target 目录上面生成对应的 jar 包,解压 jar 包目录构造如下:
jar 别离在 BOOT-INF/classes
和 BOOT-INF/lib
中蕴含应用程序的类和依赖项。相似地,可执行 war 蕴含 WEB-INF/classes
中的应用程序类和 WEB-INF/lib
和 WEB-INF/lib-provided
中的依赖项。对于须要从 jar 或 war 的内容构建 docker 镜像的状况,须要拆散这些目录以便将它们写入不同的层。
其中的 BOOT-INF/layers.idx
文件就是用来定义分层 jar 的构建程序的,层的程序很重要,因为它决定了在应用程序的一部分产生更改时,尽可能将产生更改的内容放在前面,应该先增加最不可能更改的内容,而后再增加最可能更改的层,默认程序是:
dependencies
(用于寄存不蕴含 snapshot 的依赖)spring-boot-loader
(用于寄存类加载器)snapshot-dependencies
(用于寄存蕴含 snapshot 的依赖)application
(用于寄存应用程序的类和资源)
此分层旨在依据应用程序构建之间更改的可能性来拆散代码,我的项目的依赖不太可能在外部版本之间常常更改,因而将其搁置在独自的层 dependencies
中,以容许工具从新应用缓存中的层,利用程序代码更可能在外部版本之间进行更改,因而将其隔离在独自的层 application
中。
应用上面的命令查看分层 jar 的目录程序:
java -Djarmode=layertools -jar probedemo-0.0.1-SNAPSHOT.jar list
dependencies
spring-boot-loader
snapshot-dependencies
application
应用上面的命令将 jar 包依照分层的目录构造进行解压以便创立分层镜像:
java -Djarmode=layertools -jar probedemo-0.0.1-SNAPSHOT.jar extract
对于 java -Djarmode=layertools -jar application.jar
官网的阐明如下:
Usage:
java -Djarmode=layertools -jar probedemo-0.0.1-SNAPSHOT.jar
Available commands:
list List layers from the jar that can be extracted
extract Extracts layers from the jar for image creation
help Help about any command
要禁用此个性,能够采纳以下形式
<project>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<configuration>
<layers>
<enabled>false</enabled>
</layers>
</configuration>
</plugin>
</plugins>
</build>
</project>
三、多阶段构建 docker 镜像
晓得了下面分层 jar 包的构建目录之后,咱们能够应用多阶段来构建 docker 镜像,Dockerfile
的内容如下:
# 指定根底镜像,这是多阶段构建的后期阶段
FROM openjdk:11-jre-slim as builder
# 指定工作目录,目录不存在会主动创立
WORKDIR /app
# 将生成的 jar 复制到容器镜像中
COPY target/*.jar application.jar
# 通过工具 spring-boot-jarmode-layertools 从 application.jar 中提取拆分后的构建后果
RUN java -Djarmode=layertools -jar application.jar extract
# 正式构建镜像
FROM openjdk:11-jre-slim
# 指定工作目录,目录不存在会主动创立
WORKDIR /app
# 前一阶段从 jar 中提取除了多个文件,这里别离执行 COPY 命令复制到镜像空间中,每次 COPY 都是一个 layer
COPY --from=builder app/dependencies ./
COPY --from=builder app/spring-boot-loader ./
COPY --from=builder app/snapshot-dependencies ./
COPY --from=builder app/application ./
# 指定时区
ENV TZ="Asia/Shanghai"
RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone
# 定义一些环境变量,不便环境变量传参
ENV JVM_OPTS=""ENV JAVA_OPTS=""
# 指定裸露的端口,起到阐明的作用,不指定也会裸露对应端口
EXPOSE 8080
# 启动 jar 的命令
ENTRYPOINT ["sh","-c","java $JVM_OPTS $JAVA_OPTS org.springframework.boot.loader.JarLauncher"]
应用上面的命令构建 docker 镜像:
docker build -t demo:1.0.0 .
应用如下命令查看镜像的分层信息:
docker history demo:1.0.0
如上图,整个 jar 的内容,例如 class、依赖库、依赖资源等,分屡次 COPY 到镜像空间中,所以当前如果只改了 class,在更新镜像的时候,只须要下载 class 的 layer 即可(其余 layer 能够间接用之前缓存到本地的)。
参考文章:
https://docs.spring.io/spring…
https://blog.csdn.net/boling_…