本地执行Maven构建时跳过Docker插件Push目标的最佳实践

以下是几种实用的实现方式，都是日常开发中常用的最佳实践：

1. 利用Maven Profiles区分环境 #

通过定义专属的构建配置文件，仅在需要推送镜像的环境（比如CI/CD流水线）激活推送逻辑，本地构建默认不执行推送。

在pom.xml中添加Profiles配置：

<profiles>
    <profile>
        <id>docker-push</id>
        <build>
            <plugins>
                <plugin>
                    <!-- 以spotify/docker-maven-plugin为例 -->
                    <groupId>com.spotify</groupId>
                    <artifactId>docker-maven-plugin</artifactId>
                    <configuration>
                        <imageName>your-registry/your-image:${project.version}</imageName>
                        <dockerDirectory>src/main/docker</dockerDirectory>
                    </configuration>
                    <executions>
                        <execution>
                            <id>build-and-push</id>
                            <phase>install</phase>
                            <goals>
                                <goal>build</goal>
                                <goal>push</goal> <!-- 仅在该profile激活时执行push目标 -->
                            </goals>
                        </execution>
                    </executions>
                </plugin>
            </plugins>
        </build>
    </profile>
</profiles>

• 本地构建时直接执行：mvn clean install，此时不会触发push目标
• 需要推送镜像时（比如CI环境），激活profile执行：mvn clean install -Pdocker-push

2. 命令行直接跳过推送目标 #

针对大多数Docker Maven插件，都支持通过系统参数跳过推送步骤，无需修改pom.xml：

• 如果你用的是spotify/docker-maven-plugin，本地构建时添加参数：

  mvn clean install -Ddocker.push.skip=true
  

• 如果你用的是fabric8/docker-maven-plugin，对应的参数是：

  mvn clean install -Ddocker.skip.push=true
  

这种方式灵活，适合临时需要跳过推送的场景。

3. 配置条件化的推送开关 #

在pom.xml中给Docker插件添加条件判断，通过Maven属性控制是否执行推送：

<properties>
    <!-- 默认本地构建跳过推送 -->
    <docker.push.enabled>false</docker.push.enabled>
</properties>

<build>
    <plugins>
        <plugin>
            <groupId>com.spotify</groupId>
            <artifactId>docker-maven-plugin</artifactId>
            <configuration>
                <imageName>your-registry/your-image:${project.version}</imageName>
                <dockerDirectory>src/main/docker</dockerDirectory>
                <!-- 根据属性决定是否跳过推送 -->
                <skipPush>${!docker.push.enabled}</skipPush>
            </configuration>
            <executions>
                <execution>
                    <id>build-and-push</id>
                    <phase>install</phase>
                    <goals>
                        <goal>build</goal>
                        <goal>push</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

• 本地构建默认执行mvn clean install即可跳过推送
• 需要推送时，通过参数覆盖属性：mvn clean install -Ddocker.push.enabled=true

这种方式可以把开关统一管理，适合团队协作时统一规范。

内容的提问来源于stack exchange，提问作者Mandroid