使用maven插件构建docker镜像

ゝ一纸荒年。 2023-10-05 18:53 61阅读 0赞

## 构建镜像两个关键步骤 ##

1.  将必要的文件移动到构建上下文。
2.  定义镜像构建流程。

**构建上下文**可以简单理解为就是一个目录，Dockerfile中使用的COPY，ADD等涉及到路径的指令都是相对于构建上下文而言的。

## 使用 io.fabric8/docker-maven-plugin 插件 ##

官方文档：[http://dmp.fabric8.io][http_dmp.fabric8.io]  
插件用法千奇百怪，就算是不同的配置也能实现同一种效果。这里博主比较推荐 `Dockerfile` \+ `assembly.xml` 组合拳，掌握这个组合拳便能灵活应对各种骚姿势。（最灵活的配置方式）

*  **将必要的文件移动到构建上下文**（使用assembly.xml实现）  
    官方文档：[http://maven.apache.org/plugins/maven-assembly-plugin/assembly.html][http_maven.apache.org_plugins_maven-assembly-plugin_assembly.html]
 *  **定义镜像的构建流程**（使用Dockerfile实现）  
    官方文档：[https://docs.docker.com/engine/reference/builder/][https_docs.docker.com_engine_reference_builder]

插件的构建上下文默认为 `target/docker/${镜像名}/build/`

### 示例（SpringBoot项目） ###

1.  **maven插件配置**

<plugin>
        <groupId>io.fabric8</groupId>
        <artifactId>docker-maven-plugin</artifactId>
        <version>0.33.0</version>
        <configuration>
            <verbose>true</verbose>
            
            <dockerHost>tcp://10.8.6.179:2375</dockerHost>
            <images>
                <image>
                    
                    <name>${project.artifactId}:${project.version}</name>
                    <build>
                        
                        <assembly>
                            <name>/</name>
                            <descriptor>${basedir}/docker/assembly.xml</descriptor>
                        </assembly>
                        
                        <dockerFile>${basedir}/docker/Dockerfile</dockerFile>
                    </build>
                </image>
            </images>
        </configuration>
    </plugin>

1.  **assembly.xml**（将必要的文件移动到构建上下文）  
    将打包后的文件 `target/${project.build.finalName}.${project.packaging}` 移动到**编译上下文**的`/`目录，并重命名为 `${project.artifactId}.jar`

<assembly xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.2"
            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
            xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.2 http://maven.apache.org/xsd/assembly-1.1.2.xsd">
        <files>
            <file>
                <source>target/${project.build.finalName}.${project.packaging}</source>
                <outputDirectory>/</outputDirectory>
                <destName>${project.artifactId}.jar</destName>
            </file>
        </files>
    </assembly>

1.  **Dockerfile**（定义镜像的构建流程）

FROM openjdk:8-jdk-alpine
    ADD /*.jar app.jar
    EXPOSE 8080
    ENTRYPOINT ["java", "-Djava.security.egd=file:/dev/./urandom", "-Duser.timezone=GMT+08", "-jar", "/app.jar"]

1.  启动构建  
    `mvn clean package docker:build`

另注：此插件不仅仅支持构建镜像，还可以启动容器等等。详见官方文档。

## 使用 com.spotify/docker-maven-plugin 插件 ##

官方文档：[https://github.com/spotify/docker-maven-plugin\#docker-maven-plugin][https_github.com_spotify_docker-maven-plugin_docker-maven-plugin]  
这个插件不比上面那个插件花里胡哨了。但是基本思路就是文章开头提到的两步骤。

*  **将必要的文件移动到构建上下文**（使用插件的`<resources>`配置实现）  
    相关文档：[http://maven.apache.org/plugins/maven-resources-plugin/examples/include-exclude.html][http_maven.apache.org_plugins_maven-resources-plugin_examples_include-exclude.html]
 *  **定义镜像的构建流程**（使用Dockerfile实现）  
    官方文档：[https://docs.docker.com/engine/reference/builder/][https_docs.docker.com_engine_reference_builder]

插件的构建上下文默认为 `target/docker/`

### 示例（SpringBoot项目） ###

1.  **maven插件配置**

<plugin>
        <groupId>com.spotify</groupId>
        <artifactId>docker-maven-plugin</artifactId>
        <version>0.4.13</version>
        <goals/>
        <configuration>
            <dockerHost>http://10.8.6.179:2375</dockerHost>
            <imageName>${project.artifactId}:${project.version}</imageName>
            
            <dockerDirectory>${basedir}/docker</dockerDirectory>
            
            <resources>
                <resource>
                    <directory>${basedir}/target</directory>
                    <includes>
                        <include>${project.build.finalName}.${project.packaging}</include>
                    </includes>
                    <targetPath>/</targetPath>
                </resource>
            </resources>
        </configuration>
    </plugin>

1.  **Dockerfile**（定义镜像的构建流程）

FROM openjdk:8-jdk-alpine
    ADD /*.jar app.jar
    EXPOSE 8080
    ENTRYPOINT ["java", "-Djava.security.egd=file:/dev/./urandom", "-Duser.timezone=GMT+08", "-jar", "/app.jar"]

1.  启动构建  
    `mvn clean package docker:build`

[http_dmp.fabric8.io]: http://dmp.fabric8.io
[http_maven.apache.org_plugins_maven-assembly-plugin_assembly.html]: http://maven.apache.org/plugins/maven-assembly-plugin/assembly.html
[https_docs.docker.com_engine_reference_builder]: https://docs.docker.com/engine/reference/builder/
[https_github.com_spotify_docker-maven-plugin_docker-maven-plugin]: https://github.com/spotify/docker-maven-plugin#docker-maven-plugin
[http_maven.apache.org_plugins_maven-resources-plugin_examples_include-exclude.html]: http://maven.apache.org/plugins/maven-resources-plugin/examples/include-exclude.html