一、概述

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/classesBOOT-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 listdependenciesspring-boot-loadersnapshot-dependenciesapplication

应用上面的命令将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.jarAvailable 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都是一个layerCOPY --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_...