欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

Docker使用 Maven 插件构建镜像的方法

程序员文章站 2022-06-11 12:17:48
通过 maven 的 docker 插件可以构建 docker 镜像 快速入门 在 pom.xml 中添加 docker 插件

通过 maven 的 docker 插件可以构建 docker 镜像

快速入门

在 pom.xml 中添加 docker 插件

<plugin>
  <groupid>com.spotify</groupid>
  <artifactid>docker-maven-plugin</artifactid>
  <version>0.4.13</version>
  <configuration>
    <imagename>linyuantongxue/docker-demo:0.0.1</imagename> // 指定镜像名称,linyuantongxue 是仓库名称(对应 dockerhub 用户名),docker-demo 是镜像名称(对应 dockerhub 仓库名),0.0.1 是标签名称(相当于版本号)
    <baseimage>java</baseimage>   // 指定基础镜像,等同 from 指令
    <entrypoint>["java","-jar","app.jar"]</entrypoint>    // 等同于 entrypoint 指令
    <resources>
      <resource>
        <targetpath>/</targetpath> 
        <directory>${project.build.directory}</directory>  // 指定要复制的根目录,${project.build.directory} 表示 target 目录
        <include>${project.build.finalname}.jar</include>  // 指定要复制的文件,${project.build.finalname}.jar 指打包后的 jar 文件
      </resource>
    </resources>
  </configuration>
</plugin>

执行以下命令构建 docker 镜像

mvn clean package docker:build

执行 docker images 查看刚才构建的镜像

读取 dockerfile 文件

读取 dockerfile 文件就不必指定 baseimage 和 entrypoint

<plugin>
  <groupid>com.spotify</groupid>
  <artifactid>docker-maven-plugin</artifactid>
  <version>0.4.13</version>
  <configuration>
    <dockerdirectory>${project.basedir}/src/main/docker</dockerdirectory>   // 指定要读取的 dockerfile 文件
    <imagename>linyuantongxue/docker-demo:0.0.1</imagename> // 指定镜像名称,linyuantongxue 是仓库名称(对应 dockerhub 用户名),docker-demo 是镜像名称(对应 dockerhub 仓库名),0.0.1 是标签名称(相当于版本号)
    <resources>
      <resource>
        <targetpath>/</targetpath> 
        <directory>${project.build.directory}</directory>  // 指定要复制的根目录,${project.build.directory} 表示 target 目录
        <include>${project.build.finalname}.jar</include>  // 指定要复制的文件,${project.build.finalname}.jar 指打包后的 jar 文件
      </resource>
    </resources>
  </configuration>
</plugin>

将插件绑定在某个 phase 执行

很多场景下有这样的需求,比如执行 mvn clean package 时插件就自动构建 docker 镜像,要实现这点只需要将插件的 goal 绑定在某个 phase 即可

maven 命令格式是:mvn phase:goal,phase 绑定了目标的构建生命周期阶段,goal 配置的执行目标

只需添加如下配置:

<plugin>
  <groupid>com.spotify</groupid>
  <artifactid>docker-maven-plugin</artifactid>
  <version>0.4.13</version>
  // 在 maven 生命周期 package 中执行 build 构建目标
  <executions>
    <execution>
      <id>build-image</id>
      <phase>package</phase>
      <goals>
        <goal>build</goal>
      </goals>
    </execution>
  </executions>
  // $$$$$$$$$$$$$$$$华丽的分割线$$$$$$$$$$$$$$$$
  <configuration>
    <imagename>linyuantongxue/docker-demo:0.0.1</imagename>
    <baseimage>java</baseimage>
    <entrypoint>["java","-jar","app.jar"]</entrypoint>
    <resources>
      <resource>
        <targetpath>/</targetpath>
        <directory>${project.build.directory}</directory>
        <include>${project.build.finalname}.jar</include>
      </resource>
    </resources>
  </configuration>
</plugin>

推送镜像

使用 maven 插件也可以推送镜像到 docker hub

修改 maven 全局配置信息文件 settings.xml,配置 docker hub 用户信息

<servers>
  <server>
    <id>docker-hub</id>
    # dockerhub 该网站的用户名必须全部为小写才正确
    <username>linyuantongxue</username>
    <password>765371578ly</password>
    <configuration>
      <email>765371578@qq.com</email>
    </configuration>
  </server>
</servers>

修改 pom 文件

<plugin>
  <groupid>com.spotify</groupid>
  <artifactid>docker-maven-plugin</artifactid>
  <version>0.4.13</version>
  <configuration>
    <imagename>linyuantongxue/docker-demo:0.0.1</imagename>
    <baseimage>java</baseimage>
    <entrypoint>["java","-jar","app.jar"]</entrypoint>
    <resources>
      <resource>
        <targetpath>/</targetpath>
        <directory>${project.build.directory}</directory>
        <include>${project.build.finalname}.jar</include>
      </resource>
    </resources>
    <!--与配置文件 setting.xml 中的 server.id 一致,用于推送镜像-->
    <serverid>docker-hub</serverid>
  </configuration>
</plugin>

执行以下命令,添加 pushimage 标识,表示推送镜像

mvn clean package docker:build -dpushimage

上面例子中通过 imagename 指定镜像名称和标签,也可以借助 imagetags 元素更为灵活的指定镜像名称和标签,这样就可以为同一个镜像指定两个标签

<configuration>
  <imagename>linyuantongxue/docker-demo</imagename>
  <imagetags>
    <imagetag>0.0.1</imagetag>
    <imagetag>latest</imagetag>
  </imagetags>
</configuration>

也可在构建命令时使用 dockerimagetags 参数指定标签名称

复制代码 代码如下:

mvn clean package:build -dpushimagetags -ddockerimagetags=latest -ddockerimagetags=another-tag

若需要重复构建相同标签名称的镜像,可将 forcetags 设置为 true

<configuration>
  // .......
  <forcetags>true</forcetags>
</configuration>

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。