Jib 使用小结 (Maven 插件版)
欢迎访问我的 GitHub
这里分类和汇总了欣宸的全部原创(含配套源码)：https://github.com/zq2599/blog_demos
近期在用 Jib 插件将 Java 工程构建成 Docker 镜像，使用时遇到过一些小问题，今天对这些问题做个小结；
关于 Jib 插件
Jib 是用于构建 Docker 镜像的 Maven 插件，其基本用法请参考《Docker与Jib(maven插件版)实战》一文；
全文概览
本文由以下几部分组成：
环境信息
源码下载
小结一：三种构建参数
小结二：镜像的时间问题
小结三：多次构建后，积累的无用镜像问题
小结四：提升构建速度
小结五：将 jib 与 mvn 构建的生命周期绑定
小结六：父子结构的 maven 工程如何构建
环境信息
操作系统：CentOS Linux release 7.6.1810
docker：1.13.1
jdk：1.8.0_191
maven：3.6.0
jib 插件：1.3.0
源码下载
本次实战用到的源码是个简单的 maven 工程，可以从 GitHub 上下载本次实战的源码，地址和链接信息如下表所示：
这个 git 项目中有多个文件夹，本章的源码在 hellojib 文件夹下，如下图红框所示：
小结一：三种构建参数
对于一个已在 pom.xml 中配置了 jib 插件的 java 工程来说，下面是个标准的构建命令：
注意上面的 dockerBuild 参数，该参数的意思是将镜像存入当前的镜像仓库，这样的参数一共有三种，列表说明：
小结二：镜像的时间问题
在使用命令 mvn compile jib:dockerBuild 构建本地镜像时，会遇到创建时间不准的问题：
如下所示， bolingcavalry/hellojib 是刚刚使用 jib 插件构建的镜像，其生成时间(CREATED 字段)显示的是 49 years ago ：
上面显示的镜像生成时间显然是不对的，改正此问题的方法是修改 pom.xml，在 jib 插件的 container 节点内增加 useCurrentTimestamp 节点，内容是 true，如下所示：
修改保存后再次构建，此时新的镜像的创建时间已经正确，显示 15 seconds ago ：
小结三：多次构建后，积累的无用镜像
如下所示，构建多次后，本地会遗留多个名为<none>，tag 也是<none>的镜像：
这些都是上一次构建的结果，在经历了新一轮的构建后，其镜像名和 tag 被新镜像所有，所以自身只能显示名为<none>，tag 也是<none>，清理这些镜像的命令是 docker image prune ，然后根据提示输入"y"，镜像即可被清理：
小结四：提升构建速度
在使用命令 mvn compile jib:dockerBuild 构建本地镜像时，每次构建的过程中都会提示以下信息：
每次构建都会显示上面的内容，也就是说每次都去远程拉取 base 镜像的 manifest(pulling base image manifest)，这部分时间导致整体构架时间变长，以下是构建结果，可见用了 10 秒：
首先想到的是执行命令 docker pull openjdk:8-jdk-stretch 将 base 镜像下载到本地仓库，再尝试构建，遗憾的是 jib 依旧会远程获取 base 镜像的 manifest，还是很慢；
如果能避免远程拉取 base 镜像的 manifest，镜像构建速度应该会快一些；基于此推论，优化构建速度的步骤如下：
在本机创建 registry(docker 镜像仓库服务)；
将 base 镜像 openjdk:8-jdk-stretch 放入本机 registry；
修改 pom.xml 中 base 镜像的配置，改为本机 registry 的镜像；
如此一来，每次都会从本机 registry 取得 base 镜像的 manifest，不走远程请求响应，构建时间会有提升；
接下按照上述步骤进行操作：
确认当前电脑的 IP 地址，我这里是 192.168.121.131 ；
设置本地 docker 服务支持 http：修改 docker 配置文件：/etc/docker/daemon.json，在 json 中增加内容 "insecure-registries": ["192.168.121.131:5000"]
重启 docker 使配置生效：
在本地创建一个镜像仓库服务：
查看本地镜像 openjdk:8-jdk-stretch 的 ID 为 08ded5f856cc ；
用 tag 命令将本地镜像 openjdk:8-jdk-stretch 改名，命令如下所示，"192.168.121.131"是当前电脑的 IP 地址：
再次查看镜像，发现多了个 192.168.121.131:5000/openjdk:8u212-jdk-stretch ：
将 192.168.121.131:5000/openjdk:8-jdk-stretch 推送到远程仓库，命令如下所示，由于镜像名前缀是 192.168.121.131:5000 ，镜像会被推送到我们刚刚创建的 registry：
修改 java 工程的 pom.xml，将 base 镜像由之前的 openjdk:8-jdk-stretch 改为 192.168.121.131:5000/openjdk:8-jdk-stretch
修改 java 工程的 pom.xml，增加 allowInsecureRegistries ，使 jib 插件支持 http 协议连接镜像仓库(安全起见，默认是关闭的)，整个插件的配置信息如下：
再次执行命令 mvn compile jib:dockerBuild ，如下所示，时间从之前的 10 秒缩减到 3.9 秒：
以上就是通过 registry 服务提升 jib 构建速度的方法，在多人开发的时候，registry 可以配置为一个公共的，多人都可使用，毕竟 pom.xml 代码存在公共代码仓库，每个人都去修改成自己的 registry 的地址是不合适的，一旦提交上去会影响其他人的使用，我们这里的做法是将 registry 的地址写成 host，本地维护好 host 和 IP 的映射就可以了。使用本地 registry 服务，除了提速，在服务器无法连接中央仓库取得 openjdk:8-jdk-stretch 的 manifest 时，这种方式能保证构建依旧能够成功；
小结五：将 jib 与 mvn 构建的生命周期绑定
前面的实战中构建命令是 mvn compile jib:dockerBuild ，实际上可以做到仅用 mvn compile 就完成镜像构建，这是 maven 插件的通用特性；
修改 pom.xml 增加 executions 节点，里面设置 compile 触发 jib:dockerBuild，整个插件的内容如下所示：
执行命令 mvn compile -DskipTests ，如下所示，可以成功构建镜像，与前面的命令结果一致：
小结六：父子结构的 maven 工程如何构建
假设当前 maven 工程是父子结构的，有两个子工程 A 和 B，其中 A 是二方库，提供一个 jar 包，里面是接口类和 Bean 类，B 是 springboot 应用，并且 B 的源码中用到了 A 提供的接口和 Bean；
上述父子结构的 maven 工程是常见的工程结构，此时如果要将 B 构建成 Docker 镜像，在 B 的目录下执行 mvn compile jib:dockerBuild 显然是不行的，因为没有编译构建 A，会导致 B 的编译失败；
此时最好的做法就是将 jib 与 mvn 构建的生命周期绑定，修改 B 的 pom.xml 文件，加入 executions 节点；
在父工程目录下执行 mvn compile ，此时 maven 会先编译构建整个工程，然后再将 B 工程的构建结果制作成镜像；
以上就是我在近期使用 Jib 插件时遇到的问题小结，希望这些小技巧可以给您提供一些参考，助您解决问题；
欢迎关注 InfoQ：程序员欣宸
版权声明: 本文为 InfoQ 作者【程序员欣宸】的原创文章。
原文链接:【http://xie.infoq.cn/article/576f05f6afa27d04088397591】。文章转载请联系作者。
搜索"程序员欣宸"，一起畅游Java宇宙 2018-04-19 加入
前腾讯、前阿里员工，从事Java后台工作，对Docker和Kubernetes充满热爱，所有文章均为作者原创，个人Github：https://github.com/zq2599/blog_demos
评论