需传递什么参数阻止docker-maven-plugin自动构建Docker镜像？

问题根源 #

docker-maven-plugin 4.4.0版本默认会在src/main/docker目录检测到Dockerfile时，自动将镜像构建绑定到Maven的构建生命周期（如package阶段），导致无需额外触发就自动执行构建。

解决方案 #

通过配置插件默认跳过构建，仅在传入指定CLI参数时才触发构建：

1. 修改pom.xml配置 #

在docker-maven-plugin的configuration节点中添加skip属性，默认设为true，确保默认不执行构建：

<plugin>
  <groupId>io.fabric8</groupId>
  <artifactId>docker-maven-plugin</artifactId>
  <version>4.4.0</version>
  <configuration>
    <skip>true</skip> <!-- 默认跳过所有Docker操作 -->
    <image>
      <build>
        <dockerFile>${project.basedir}/src/main/docker/Dockerfile</dockerFile>
        <basedir>${project.basedir}</basedir>
        <contextDir>${project.basedir}</contextDir>
        <tags>
          <tag>${project.version}</tag>
        </tags>
      </build>
    </image>
  </configuration>
</plugin>

如果只想针对镜像构建阶段跳过，也可以在build节点下单独配置skip：

<image>
  <build>
    <skip>true</skip> <!-- 仅默认跳过镜像构建 -->
    <dockerFile>${project.basedir}/src/main/docker/Dockerfile</dockerFile>
    <basedir>${project.basedir}</basedir>
    <contextDir>${project.basedir}</contextDir>
    <tags>
      <tag>${project.version}</tag>
    </tags>
  </build>
</image>

2. 通过CLI参数触发构建 #

当需要构建镜像时，执行Maven命令时传入对应的参数覆盖默认配置：

• 如果配置了全局skip，使用：

  mvn package -Ddocker.skip=false
  

• 如果仅配置了build节点下的skip，使用：

  mvn package -Ddocker.build.skip=false
  

这样就能完全通过CLI参数控制镜像构建的触发，避免插件自动执行构建逻辑。

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