前提
- docker
- 容器镜像仓库
这里举例可以公用的两个
dockerhub
阿里云容器镜像服务
前言
本文主要介绍的是google开源的一个java领域的docker构建工具jib.
目前在github上的start有8.5k,fork有784,是一款非常方便的java领域docker构建工具.
亮点是不需要Docker daemon,意味着即使本地没有安装docker也能通过jib构建docker镜像,并且可以构建符合OCI规范的镜像.
官方支持三种方式:
本文使用的是springboot项目通过maven插件的方式进行讲述.
讲一下第三种,jib代码库,这种方式可以用于自研平台构建java的docker服务.
配置pom.xml
添加下面这段标准标签到文件中
<build>
<plugins>
...
<plugin>
<groupId>com.google.cloud.tools</groupId>
<artifactId>jib-maven-plugin</artifactId>
<version>2.0.0</version>
<configuration>
<from>
<image>registry.cn-hangzhou.aliyuncs.com/dragonwell/dragonwell8:8.1.1-GA_alpine_x86_64_8u222-b67</image>
</from>
<to>
<image>imageName</image>
</to>
</configuration>
</plugin>
...
</plugins>
</build>
上述内容配置了一个结果镜像名称imageName,也就是最终构建成的docker镜像地址,包含容器仓库地址/镜像名称:版本号例如registry.cn-beijing.aliyuncs.com/lyp/lanbox:v1.0,如果仓库地址不填则默认为dockerhub.
另外还配置了一个基础镜像registry.cn-hangzhou.aliyuncs.com/dragonwell/dragonwell8:8.1.1-GA_alpine_x86_64_8u222-b67,可以认为等同于Dockerfile中的From语句.
如果基础镜像或目标镜像需要账号密码的话,在from标签或to标签添加一个认证信息即可,有三种方式:
- 配置在docker的配置文件中
- 配置在maven的setting.xml中
- 直接在pom.xml文件配置
本文使用第三种,即在from标签或to标签下添加一个用于认证信息的auth标签,例如:
<from>
...
<auth>
<username>kafeidou</username>
<password>kafeidou</password>
<auth>
...
</from>
也可以方便的通过环境变量的方式进行配置:
<from>
...
<auth>
<username>${env.REGISTRY_FROM_USERNAME}</username>
<password>${env.REGISTRY_FROM_PASSWORD}</password>
<auth>
...
</from>
其中${env.}这一部分是固定的,后面跟着实际环境变量.
还可以通过系统属性的方式:
mvn compile jib:build \
-Djib.to.image=myregistry/myimage:latest \
-Djib.to.auth.username=kafeidou \
-Djib.to.auth.password=kafeidou
在进行构建时通过参数方式传递认证信息,是不是很方便呢?
继续看configuration下的标签有container配置:
这个标签主要配置目标容器相关的内容,比如:
- appRoot -> 放置应用程序的根目录,用于war包项目
- args -> 程序额外的启动参数.
- environment -> 用于容器的环境变量
- format -> 构建OCI规范的镜像
- jvmFlags -> JVM参数
- mainClass -> 程序启动类
- ports -> 容器开放端口
...
还有其他内容具体可以参考https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin#container-object.
有一个注意点是阿里的容器镜像服务不支持OCI镜像,所以如果选择使用阿里的容器镜像服务记得将OCI格式取消,默认是取消的.
另外,JVM参数可以通过环境变量配置动态内容,所以不需要计划将所有启动参数写死在jvmFlags标签里面.
例如启动容器时指定使用G1回收器,docker run -it -e JAVA_TOOL_OPTIONS="-XX:+UseG1GC" -d registry.cn-beijing.aliyuncs.com/lyp/lanbox:v1.0.
所有配置项完成后运行mvn命令mvn compile jib:build 开始构建docker镜像.
如果看到类似这样的信息说明就成功了:
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 42.598 s
[INFO] Finished at: 2020-02-18T23:30:53+08:00
[INFO] ------------------------------------------------------------------------
完整的一个例子可以在github上查看并下载https://github.com/FISHStack/hello-spring-cloud,欢迎多多交流.
始发于 四颗咖啡豆 ,转载请声明出处.欢迎交流
