阅读数:193 评论数:0

目的

在你的maven项目中创建一个Docker镜像。比方说，build过程可以为java服务输出一个可以运行该服务的Docker镜像。

步骤

有两种配置方式，一种是通过Dockerfile文件，一种是直接在pom.xml配置。

如果你需要VOLUME命令（或者其他pom.xml不支持使用的命令），还是需要通过将命令写入Dockerfile，并通过pom中配置dockerDirectory来引入该Dockerfile。

默认情况下，该插件通过访问localhost:2375来连接本地docker，可以通过设置DOCKER_HOS环境变量来连接docker.

1、在pom中声明构建信息

下面的代码示例创建了名为example的新镜像，将项目编译的jar 包拷贝到镜像中，并设置了一个entrypoint去运行这个jar。

<build>
  <plugins>
    ...
    <plugin>
      <groupId>com.spotify</groupId>
      <artifactId>docker-maven-plugin</artifactId>
      <version>VERSION GOES HERE</version>
      <configuration>
        <imageName>example</imageName>
        <baseImage>java</baseImage>
        <entryPoint>["java", "-jar", "/${project.build.finalName}.jar"]</entryPoint>
        <!-- copy the service's jar file from target into the root directory of the image --> 
        <resources>
           <resource>
             <targetPath>/</targetPath>
             <directory>${project.build.directory}</directory>
             <include>${project.build.finalName}.jar</include>
           </resource>
        </resources>
      </configuration>
    </plugin>
    ...
  </plugins>
</build>

（1）imageName

镜像的名称

（2）baseImage

基础镜像，这里相当于Dockerfile的FROM java

（3）resource

构建时会生成docker文件夹，这里指生成文件夹的内容来源，包含了mvn clean package之后的target的文件和生成的jar 包。

2、使用dockerfile

为了使用Dockerfile，必须在pom的文件中通过dockerDirectory来指明Dockerfile文件的所在目录，如果配置了dockerDirectory，baseImage、maintainer、cmd和entryPoint配置将忽略。下面的配置会将dockerDirectory的内容拷贝到${project.build.directory}/docker。

<build>
  <plugins>
    ...
    <plugin>
      <groupId>com.spotify</groupId>
      <artifactId>docker-maven-plugin</artifactId>
      <version>VERSION GOES HERE</version>
      <configuration>
        <imageName>example</imageName>
        <dockerDirectory>docker</dockerDirectory>
        <resources>
           <resource>
             <targetPath>/</targetPath>
             <directory>${project.build.directory}</directory>
             <include>${project.build.finalName}.jar</include>
           </resource>
        </resources>
      </configuration>
    </plugin>
    ...
  </plugins>
</build>

使用

按照上面的配置之后，可以使用如下命令生成一个镜像

mvn clean package docker:build

将生成的镜像推送到镜像注册中心，通过pushImage标签

mvn clean package docker:build -DpushImage

在中可以配置imageTag

<build>
  <plugins>
    ...
    <plugin>
      <configuration>
        ...
        <imageTags>
           <imageTag>${project.version}</imageTag>
           <imageTag>latest</imageTag>
        </imageTags>
      </configuration>
    </plugin>
    ...
  </plugins>
</build>
 

使用pushImageTag推送指定tag的镜像

mvn clean package docker:build -DpushImageTag

如果想强制docker每次构建上覆盖镜像tags，可配置forceTags

<build>
  <plugins>
    ...
    <plugin>
      <configuration>
        ...
        <!-- optionally overwrite tags every time image is built with docker:build -->
        <forceTags>true</forceTags>
        <imageTags>
           ...
        </imageTags>
      </configuration>
    </plugin>
    ...
  </plugins>
</build>