Docker构建时如何传递带点ARG参数？兼容Maven与Docker Compose

核心问题是Docker Compose不支持带点号（.）的构建参数名，而Maven的project.version是标准属性无法修改。以下是几种兼容两边的解决方案：

方案一：Dockerfile兼容双参数 #

在Dockerfile中同时定义两种格式的ARG，通过默认值逻辑自动适配不同构建工具：

# 优先使用带点的参数（适配Fabric8），不存在则使用下划线格式（适配Docker Compose）
ARG project.version
ARG project_version
LABEL version=${project.version:-${project_version}}

对应配置 #

• docker-compose.yml：使用下划线格式的参数

  ...
  args:
    project_version: 1.0.0
  

• Fabric8插件配置（pom.xml）：继续传递带点的Maven属性

  <plugin>
    <groupId>io.fabric8</groupId>
    <artifactId>docker-maven-plugin</artifactId>
    <configuration>
      <images>
        <image>
          <build>
            <args>
              <project.version>${project.version}</project.version>
            </args>
          </build>
        </image>
      </images>
    </configuration>
  </plugin>
  

方案二：通过环境变量统一参数传递 #

统一使用下划线格式的ARG，通过环境变量在Maven和Docker Compose之间传递值：

步骤1：修改Dockerfile #

ARG project_version
LABEL version=${project_version}

步骤2：配置docker-compose.yml #

通过环境变量接收版本值：

...
args:
  project_version: ${PROJECT_VERSION}

步骤3：Maven端配置 #

• Fabric8插件：直接映射Maven属性到下划线参数

  <plugin>
    <groupId>io.fabric8</groupId>
    <artifactId>docker-maven-plugin</artifactId>
    <configuration>
      <images>
        <image>
          <build>
            <args>
              <project_version>${project.version}</project_version>
            </args>
          </build>
        </image>
      </images>
    </configuration>
  </plugin>
  

• Docker Compose构建：通过Maven命令导出环境变量再执行构建（可配合Maven Exec插件自动化）

  export PROJECT_VERSION=$(mvn help:evaluate -Dexpression=project.version -q -DforceStdout)
  docker-compose build
  

方案三：Maven动态生成Docker Compose配置 #

使用Maven资源过滤功能，在构建时自动将带点的Maven属性替换为Docker Compose支持的下划线参数：

步骤1：创建模板文件 #

创建docker-compose.yml.template：

...
args:
  project_version: ${project.version}

步骤2：配置Maven资源过滤 #

在pom.xml中添加资源过滤，将模板生成最终的docker-compose.yml：

<build>
  <resources>
    <resource>
      <directory>src/main/docker</directory>
      <includes>
        <include>docker-compose.yml.template</include>
      </includes>
      <filtering>true</filtering>
      <targetPath>${project.build.directory}/docker</targetPath>
    </resource>
  </resources>
</build>

步骤3：构建与使用 #

执行mvn resources:resources生成最终配置，然后使用${project.build.directory}/docker/docker-compose.yml进行构建。

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