关于《SpringBoot-2.3 容器化技术》系列
《SpringBoot-2.3 容器化技术》系列,旨在和大家一起学习实践 2.3 版本带来的最新容器化技术,让咱们的 Java 应用更加适应容器化环境,在云计算时代依旧紧跟主流,保持竞争力;
全系列文章分为主题和辅助两部分,主题部分如下:
- 《体验 SpringBoot(2.3) 应用制作 Docker 镜像 (官方方案)》;
- 《详解 SpringBoot(2.3) 应用制作 Docker 镜像 (官方方案)》;
- 《掌握 SpringBoot-2.3 的容器探针:基础篇》;
- 《掌握 SpringBoot-2.3 的容器探针:深入篇》;
- 《掌握 SpringBoot-2.3 的容器探针:实战篇》;
辅助部分是一些参考资料和备忘总结,如下:
- 《SpringBoot-2.3 镜像方案为什么要做多个 layer》;
- 《设置非 root 账号不用 sudo 直接执行 docker 命令》;
- 《开发阶段,将 SpringBoot 应用快速部署到 K8S》;
本篇简介
在前文,咱们快速体验了官方推荐的 docker 镜像制作方案,但也产生了几个疑问:
- SpringBoot-2.3 版本推荐的镜像构建方案和旧版本比有什么不同?
- pom.xml 中 <font color=”blue”>spring-boot-maven-plugin</font> 插件新增的参数,到底做了什么?
- Dockerfile 中,<font color=”blue”>java -Djarmode=layertools -jar application.jar extract</font> 这个操作啥意思?
本篇的目标就是解答上述问题,在寻找答案的过程中不断补全知识点,提升自己;
关键知识点:镜像 layer
前文多次提到的镜像 layer 到底是什么,为什么会有多层 layer?有必要先把这个知识点夯实了,请参考文章《SpringBoot-2.3 镜像方案为什么要做多个 layer》
老版本 SpringBoot 的官方方案
以 <font color=”blue”>SpringBoot-2.2.0.RELEASE</font> 版本为例,官方文档 (
https://docs.spring.io/spring…:
- 将 SpringBoot 工程编译构建,在 target 目录得到 jar;
- 在 target 目录新建 dependency 文件夹;
- 将 jar 解压到 dependency 文件夹;
- 编写 Dockerfile 文件,内容如下:
FROM openjdk:8-jdk-alpine
VOLUME /tmp
ARG DEPENDENCY=target/dependency
COPY ${DEPENDENCY}/BOOT-INF/lib /app/lib
COPY ${DEPENDENCY}/META-INF /app/META-INF
COPY ${DEPENDENCY}/BOOT-INF/classes /app
ENTRYPOINT ["java","-cp","app:app/lib/*","com.example.MyApplication"]
- 可见,官方推荐的做法是将整个 jar 文件解压,在 Dockerfile 中多次用 COPY 命令分别复制,这样做的好处显而易见:多个 layer,如果镜像的新版本中只修改了应用代码,那么下载镜像时只会下载 /app 这个 layer,其他部分直接使用本地缓存,这是 docker 镜像的常规优化手段;
- 上述方案有个小问题:<font color=”red”> 麻烦!!!</font>
- 于是 2.3.0.RELEASE 版本做了些优化,让事情变得简单些;
2.3.0.RELEASE 版本方案和旧版的区别
2.3.0.RELEASE 版本构建 Docker 的步骤如下:
- pom.xml 中的 spring-boot-maven-plugin 插件增加一个配置项;
2. 编译构建生成 jar;
- 编写 Dockerfile,里面用到了多阶段构建 (multi-stage builds),用工具从 jar 中提取拆分后,再多次执行 COPY 命令将拆分后的内容放入镜像,达到多个 layer 的目的;
因此,2.3.0.RELEASE 版本和旧版本相比有如下变化:
- <font color=”blue”>pom.xml</font> 中多了个参数;
- 构建好 jar 后,无需自己解压 jar;
- Dockefile 内容不一样,旧版是手动解压 jar,再在 Dockerfile 分别复制,2.3.0.RELEASE 是通过 <font color=”red”>java 命令从 jar 中提取出各部分内容 </font>;
搞清楚了新旧版本的区别,咱们继续研究下一个问题吧;
pom.xml 中 spring-boot-maven-plugin 插件新增的参数
- pring-boot-maven-plugin 插件新增参数如下图所示:
- 上述参数有啥用?我这边编译构建了两次 jar,第一次有上述参数,第二次没有,将两次生成的 jar 解压后对比,发现用了上述参数后,生成的 jar 会多出下图红框中的两个文件:
- 看看 <font color=”blue”>layers.idx</font> 文件的内容,如下图:
- 上图中的内容分别是什么意思呢?官方已给出了详细解释,如下图红框:
- 综上所述,layers.idx 文件是个清单,里面记录了所有要被复制到镜像中的信息,接下来看看如何使用 layers.idx 文件,这就涉及到 jar 包中新增的另一个文件:<font color=”blue”>spring-boot-jarmode-layertools-2.3.0.RELEASE.jar</font>
spring-boot-jarmode-layertools 工具
- 前面已经介绍过 jar 中除了 layers.idx,还多了个文件:<font color=”blue”>spring-boot-jarmode-layertools-2.3.0.RELEASE.jar</font>,来看看这个文件的用处;
- 进入工程的 <font color=”blue”>target</font> 目录,这里面是编译后的 jar 文件 (我这里文件名为 dockerlayerdemo-0.0.1-SNAPSHOT.jar),注意此时的 <font color=”blue”>spring-boot-maven-plugin</font> 插件是带上了下图红框中的参数的:
- 执行以下命令:
java -Djarmode=layertools -jar dockerlayerdemo-0.0.1-SNAPSHOT.jar list
- 得到结果如下图所示,是 layers.idx 文件的内容:
- 来看看官方对这个 <font color=”blue”>layertools</font> 的解释,list 参数的作用上面我们已经体验过了,重点是红框中的 <font color=”red”>extract</font> 参数,它的作用是从 jar 中提取构建镜像所需的内容:
- 看到这里,您是否想到了《体验 SpringBoot(2.3) 应用制作 Docker 镜像 (官方方案)》中 Dockerfile 的内容,请看下图的红框和红字,是否有种恍然大悟的感觉:jar 构建生成清单 layers.idx,Dockerfile 中根据清单从 jar 提取文件放入镜像:
至此,三个问题都已经找到了答案,小结一下:
SpringBoot-2.3.0.RELEASE 推荐的镜像构建方案和旧版本相比有什么不同
- pom.xml 中的 spring-boot-maven-plugin 插件增加一个配置项;
- 构建好 jar 后,旧版本要自己解压 jar,新版不需要;
- 新版本的 jar 中,多了个文件清单 <font color=”blue”>layers.idx</font> 和镜像文件处理工具 <font color=”blue”>spring-boot-jarmode-layertools-2.3.0.RELEASE.jar</font>;
- 旧版的 Dockefile 内容:因为前面解压好了,所有在 Dockerfile 里直接复制前面解压的内容,这里就有个风险:前一步解压和当前复制的文件位置要保证一致;
- 新版的 Dockerfile 内容:使用工具 spring-boot-jarmode-layertools-2.3.0.RELEASE.jar,根据的 layers.idx 内容从 jar 中提取文件,复制到镜像中;
- 新版的 Dockerfile 中,由于使用了分阶段构建,因此从 jar 提取文件的操作不会保存到镜像的 layer 中;
pom.xml 中 spring-boot-maven-plugin 插件新增的参数,到底做了什么
spring-boot-maven-plugin 插件新增的参数,使得编译构建得到 jar 中多了两个文件,如下图所示:
Dockerfile 中,java -Djarmode=layertools -jar application.jar extract 这个操作啥意思
- <font color=”blue”>java -Djarmode=layertools -jar application.jar extract</font> 的作用是从 jar 中提取文件,这些文件是 docker 镜像的一部分;
- 上述操作的参数是 <font color=”blue”>extract</font>,另外还有两个参数,官方解释它们的作用如下:
至此,问题已全部澄清,相信您对 SpringBoot-2.3.0.RELEASE 官方的镜像构建方案也足够了解了,最后是我根据自己的认识画的流程图,帮助您快速理解整个构建流程:
欢迎访问我的 GitHub
- 地址:https://github.com/zq2599/blog_demos
- 内容:原创文章分类汇总,及配套源码,涉及 Java、Docker、K8S、DevOPS 等
欢迎关注我的公众号:程序员欣宸
https://github.com/zq2599/blog_demos