站长资源服务器

Spring Cloud中使用jib进行docker部署的步骤详解

整理:jimmy2024/12/23浏览2
简介Jib介绍Jib 是 Google 开发的可以直接构建 Java 应用的 Docker 和 OCI 镜像的类库,以 Maven 和 Gradle 插件形式提供。通过 Jib,Java 开发者可以使用他们熟悉的 Java 工具来构建容器。Jib 是一个快速而简单的容器镜像构建工具,它负责处理将应用

Jib介绍

Jib 是 Google 开发的可以直接构建 Java 应用的 Docker 和 OCI 镜像的类库,以 Maven 和 Gradle 插件形式提供。

通过 Jib,Java 开发者可以使用他们熟悉的 Java 工具来构建容器。Jib 是一个快速而简单的容器镜像构建工具,它负责处理将应用程序打包到容器镜像中所需的所有步骤。它不需要你编写 Dockerfile 或安装 Docker,而且可以直接集成到 Maven 和 Gradle中 —— 只需要将插件添加到构建中,就可以立即将 Java 应用程序容器化。

jib开源地址:https://github.com/GoogleContainerTools/jib

普通方式Docker构建流程

Spring Cloud中使用jib进行docker部署的步骤详解

Jib构建流程

Spring Cloud中使用jib进行docker部署的步骤详解

集成Jib

项目是Spring Cloud,版本Hoxton.SR1。

Spring Cloud中使用jib进行docker部署的步骤详解

集成jib只需要在pom里面加入jib的插件

<plugin>
        <groupId>com.google.cloud.tools</groupId>
        <artifactId>jib-maven-plugin</artifactId>
        <version>${jib.version}</version>
      </plugin>

jib相关完整配置

<properties>
    <!-- jib docker config-->
    <!--    jib 版本-->
    <jib.version>2.2.0</jib.version>
    <!--    是否跳过jib打包-->
    <jib.skip>true</jib.skip>
    <!--    仓库镜像名称-->
    <jib.repository.name>akk-system</jib.repository.name>
    <!--    启动类-->
    <jib.main.class>com.akk.GatewayApplication</jib.main.class>
    <!--    仓库登录用户名-->
    <REGISTRY_USERNAME>222222222222</REGISTRY_USERNAME>
    <!--    仓库登录密码-->
    <REGISTRY_PASSWORD>111111111111</REGISTRY_PASSWORD>
</properties>
 <plugins>
    <plugin>
      <groupId>com.google.cloud.tools</groupId>
      <artifactId>jib-maven-plugin</artifactId>
      <version>${jib.version}</version>
      <configuration>
        <skip>${jib.skip}</skip>
        <!-- 配置基础镜像-->
        <from>
          <image>openjdk:8-jre-alpine</image>
        </from>
        <!-- 配置推送地址,仓库名,镜像名-->
        <to>
          <image>registry.cn-hangzhou.aliyuncs.com/akk_java/${jib.repository.name}</image>
          <tags>
            <!-- <tag>${jib.repository.name}</tag>-->
            <!-- <tag>${version}</tag>-->
          </tags>
          <auth>
            <username>${REGISTRY_USERNAME}</username>
            <password>${REGISTRY_PASSWORD}</password>
          </auth>
        </to>
        <!--私服是http不是https,默认jib不推送到非https的私服,私服添加,公服不添加-->
        <!--          <allowInsecureRegistries>true</allowInsecureRegistries>-->
        <container>
          <mainClass>${jib.main.class}</mainClass>
          <labels>
            <name>${artifactId}</name>
          </labels>
        </container>
      </configuration>
      <!--绑定到maven lifecicle-->
      <!--        <executions>-->
      <!--          <execution>-->
      <!--            <phase>package</phase>-->
      <!--            <goals>-->
      <!--              <goal>build</goal>-->
      <!--            </goals>-->
      <!--          </execution>-->
      <!--        </executions>-->
    </plugin>
  </plugins>

参数说明:
${jib.version}jib版本:自行选择即可
${jib.skip}是否跳过jib:jib插件放在根目录下面的pom内,所以项目的所有模块会进行jib操作。如项目的公共依赖模块不需打包的,可以重新定义此属性,跳过jib
${jib.repository.name}镜像的推送仓库名称:仓库名称
${version}镜像版本:推送镜像的版本
${REGISTRY_USERNAME}镜像仓库用户名:私有仓库的登录账号
${REGISTRY_PASSWORD}镜像仓库密码:私有仓库的登录密码
${jib.main.class}项目模块启动类:项目模块的启动类,Spring boot启动类

form标签定义了基础镜像,此处基于openjdk:8-jre-alpine,可以使用其他。to标签定义编译后的镜像推送信息,image定义推送镜像名称信息,tags推送镜像的tag,可以通过tag拉取指定镜像。 auth定义私有仓库的登录信息。container定义镜像的内容信息,mainClass启动的主类。labels应用元数据键值对,类似于docker的label。下面的executions进行了命令的绑定,此处将jib的build命令绑定到了maven的package命令上,当运行mvn package时,会自动执行jib build。(更多配置标签参考https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin )

此时idea的maven菜单中就可以看到jib插件相关内容:

Spring Cloud中使用jib进行docker部署的步骤详解

如:gateway模块(需要打包镜像),pom配置如下

<"1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <parent>
    <artifactId>akk-system</artifactId>
    <groupId>com.akk</groupId>
    <version>0.0.1-SNAPSHOT</version>
  </parent>
  <modelVersion>4.0.0</modelVersion>

  <artifactId>gateway</artifactId>

  <properties>
    <!-- jib docker config-->
    <jib.version>2.2.0</jib.version>
    <jib.skip>false</jib.skip>
    <jib.repository.name>akk-gateway</jib.repository.name>
    <jib.main.class>com.akk.GatewayApplication</jib.main.class>
  </properties>

  <dependencies>
    <dependency>
      <groupId>org.springframework.cloud</groupId>
      <artifactId>spring-cloud-starter-gateway</artifactId>
    </dependency>
    <dependency>
      <groupId>com.github.xiaoymin</groupId>
      <artifactId>knife4j-spring-boot-starter</artifactId>
    </dependency>
  </dependencies>

</project>

common公共依赖包pom(不需要打包镜像):

<"1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <parent>
    <artifactId>akk-system</artifactId>
    <groupId>com.akk</groupId>
    <version>0.0.1-SNAPSHOT</version>
  </parent>
  <artifactId>common</artifactId>
  <version>0.0.1-SNAPSHOT</version>

  <properties>
    <!-- jib docker config-->
    <jib.version>2.2.0</jib.version>
    <jib.skip>true</jib.skip>
    <jib.repository.name>akk-system</jib.repository.name>
    <jib.image.name>akk-system</jib.image.name>
  </properties>

  <dependencies>
    <!-- 依赖信息-->
  </dependencies>

</project>

其中properties覆盖了jib的相关参数配置。

打包镜像

运行mvn package jib:dockerBuild进行打包。

Spring Cloud中使用jib进行docker部署的步骤详解

打包完成,查看本地docker镜像(jib:dockerBuild 命令不会上传镜像,使用jib:build命令则会上传镜像)

Spring Cloud中使用jib进行docker部署的步骤详解

打包并上传镜像

运行mvn package jib:build进行打包并上传。
登录docker私有仓库

docker login --username=username --password=password registry.cn-hangzhou.aliyuncs.com

拉取镜像

docker pull registry.cn-hangzhou.aliyuncs.com/akk_java/akk-gateway:latest

Spring Cloud中使用jib进行docker部署的步骤详解

docker部署项目

微服务项目部署,模块较多,一般为分布式集群环境,所以手动部署比较麻烦,可以使用Jenkins类似的自动化部署工具。使用Jenkins进行打包上传镜像之后,登录到远程服务器,执行脚本进行启动。如:

#!/bin/bash
# 登录docker仓库
docker login --username=username --password=password registry.cn-hangzhou.aliyuncs.com
# 停止运行的容器
docker ps | grep akk_java | awk '{print $1}' | xargs docker stop
# 删除容器
docker ps -a -q | grep akk_java | awk '{print $1}' | xargs docker rm
# 查询镜像文件并删除
docker images | grep akk_java | awk '{print $3}' | xargs docker rmi
# 拉取镜像
docker pull registry.cn-hangzhou.aliyuncs.com/akk_java/akk-user:latest
docker pull registry.cn-hangzhou.aliyuncs.com/akk_java/akk-gateway:latest
docker pull registry.cn-hangzhou.aliyuncs.com/akk_java/akk-task:latest
docker pull registry.cn-hangzhou.aliyuncs.com/akk_java/akk-store:latest
docker pull registry.cn-hangzhou.aliyuncs.com/akk_java/akk-pay:latest
docker pull registry.cn-hangzhou.aliyuncs.com/akk_java/akk-app-api:latest
docker pull registry.cn-hangzhou.aliyuncs.com/akk_java/akk-sso-auth:latest
docker pull registry.cn-hangzhou.aliyuncs.com/akk_java/akk-seata:latest

重新拉取镜像之后,执行docker run命令启动docker就行了。