使用 JKube 构建Springboot应用的Docker镜像

JKube 的作用

JKube 省去了配置  Dockerfile, k8s manifest 的过程。自动化了 docker 镜像的构建。极大提高了 Java 应用云原生环境集成的效率。

使用 JKube 来构建 Java 应用的镜像， 只需要引入 kubernetes-maven-plugin 就可以了。

JKube 的工作原理

这个 插件在执行 build, push 命令的时候，会使用自动 的 Generator 来生成镜像。

mvn clean package k8s:build k8s:push

Generator 会自动检测开发框架。支持  Spring Boot, Quarkus, Vert.x 等等框架。

运行 k8s:build 的时候， 会显示默认使用的基础镜像，打包 package 出来的应用。

参考：

Java development on top of Kubernetes using Eclipse JKube | Red Hat Developer

使用步骤

1.应用 build 的插件（在 pom.xml 的 build 节点增加 plugin）：

<plugin>

    <groupId>org.eclipse.jkube</groupId>

    <artifactId>kubernetes-maven-plugin</artifactId>

    <version>${jkube.version}</version>

</plugin>

2.在 pom.xml 文件的 properties 里面设置镜像的名称：

<jkube.generator.name>docker.io/rohankanojia/random-generator:${project.version}</jkube.generator.name>

即可正确打包出来

org.eclipse.jkube/kubernetes-maven-plugin

3.运行命令打包，部署到 kubernetes 集群, 推送到镜像仓库等。

mvn clean package k8s:build k8s:apply k8s:push

如果执行的时候提示没有 image build 的配置，错误消息如下：

 [WARNING] k8s: No image build configuration found or detected

说明没有自动识别项目，可以在 build 中加上 spring-boot-maven-plugin。

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <excludes>
                        <exclude>
                            <groupId>org.projectlombok</groupId>
                            <artifactId>lombok</artifactId>
                        </exclude>
                    </excludes>
                </configuration>
            </plugin>
        </plugins>
    </build>

4.build 的时候自动部署到开发环境的 k8s （可选）

<plugin>

     <groupId>org.eclipse.jkube</groupId>

     <artifactId>kubernetes-maven-plugin</artifactId>

     <version>${project.version}</version>

     <executions>

         <execution>

             <goals>

                  <goal>build</goal>

                  <goal>resource</goal>

                  <goal>apply</goal>

             </goals>

         </execution>

     </executions>

</plugin>

JKube 依赖：

本地启动了 docker 服务， build需要。 Apply 需要本地有配置好的 k8s 客户端。

其他说明：

1).对于多 module 的项目， 如果有多个 module 都是 spring boot 应用。 在每个模块的 pom 里面指定不同的仓库名称即可。例如一个多module的项目里面， 有 sentinel-server, notification-server 两个 spring boot 应用，两个模块 pom 中的 generate name 如下：

<jkube.generator.name>docker.io/rohankanojia/sentinel-server:${project.version}</jkube.generator.name>

<jkube.generator.name>docker.io/rohankanojia/notification-server:${project.version}</jkube.generator.name>

2).构建的镜像里面， 有一些占位符可以使用，用来生成不同的动态的版本号，如 %l, %t

org.eclipse.jkube/kubernetes-maven-plugin

如：

<jkube.generator.name>cn-beijing.cr.aliyuncs.com/rohankanojia/notification-service:%t</jkube.generator.name>