Spring Boot Maven Plugin结合Paketo Buildpacks在GitLab流水线绑定失效

本地执行spring-boot:build-image时，bindings配置能正常将${project.basedir}/src/folder绑定到构建容器的/workspace/CONTAINER-INF/folder，但GitLab CI中构建失败，核心原因是：

• 你在GitLab CI中使用Docker套接字绑定（DOCKER_HOST: '/var/run/docker.sock'），此时spring-boot:build-image调用的是GitLab Runner主机上的Docker守护进程来启动Paketo构建容器。
• Maven运行在maven:3.8.3-openjdk-17容器内，${project.basedir}指向的是该容器内的项目路径，但主机的Docker守护进程无法访问这个容器内的路径，导致绑定失效，文件无法复制到镜像中。

推荐两种可靠的解决方式，优先选择方式1：

方式1：通过Maven资源插件将文件纳入构建产物 #

放弃使用bindings，改用Maven的maven-resources-plugin将目标文件夹复制到Paketo会自动打包的目录中，确保文件被纳入镜像：

1. 在pom.xml中添加资源插件配置：

<build>
    <plugins>
        <!-- 保留原有的spring-boot-maven-plugin配置 -->
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <!-- 你的现有配置... -->
        </plugin>

        <!-- 添加自定义资源复制插件 -->
        <plugin>
            <artifactId>maven-resources-plugin</artifactId>
            <executions>
                <execution>
                    <id>copy-custom-folder</id>
                    <phase>process-resources</phase>
                    <goals>
                        <goal>copy-resources</goal>
                    </goals>
                    <configuration>
                        <outputDirectory>${project.build.directory}/classes/CONTAINER-INF/folder</outputDirectory>
                        <resources>
                            <resource>
                                <directory>${project.basedir}/src/folder</directory>
                                <filtering>false</filtering>
                            </resource>
                        </resources>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

2. 删除spring-boot-maven-plugin配置中的<bindings>段。

执行mvn spring-boot:build-image时，Maven会先将src/folder的文件复制到target/classes/CONTAINER-INF/folder，Paketo构建镜像时会自动将target/classes下的内容纳入应用镜像的对应目录，确保文件出现在镜像内。

方式2：调整GitLab CI的路径映射（适配bindings） #

如果坚持使用bindings，需要确保Docker守护进程能访问到项目目录：

1. 修改GitLab CI配置，显式指定主机侧的项目目录路径：

stage: etc
image: maven:3.8.3-openjdk-17
variables:
    DOCKER_HOST: '/var/run/docker.sock'
    PROJECT_DIR: '/builds/${CI_PROJECT_NAMESPACE}/${CI_PROJECT_NAME}'
script:
  - mvn spring-boot:build-image -Dproject.basedir=${PROJECT_DIR}

2. 同步修改pom.xml中的bindings路径：

<bindings>
    <binding>${PROJECT_DIR}/src/folder:/workspace/CONTAINER-INF/folder:ro</binding>
</bindings>

这种方式依赖GitLab Runner的固定工作目录结构，通用性稍差，不如方式1稳定。

修改后重新执行GitLab CI构建，进入镜像检查/workspace/CONTAINER-INF/folder目录是否存在目标文件。

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