rgisler/maven

Maven-Docker集成镜像

镜像概述

本镜像基于Eclipse Temurin构建的Maven基础镜像扩展而来，集成了Docker二进制文件，为Maven项目提供容器化构建和测试所需的完整环境。通过预安装Docker工具，使Fabric8 Maven插件、Google Jib插件及TestContainers等依赖Docker环境的工具可直接运行，无需额外配置宿主环境。

核心功能与特性

• 基础环境：包含Maven x.y.z和JDK-zz（基于Eclipse Temurin，提供稳定可靠的Java运行环境）
• Docker集成：内置Docker二进制文件，支持Docker命令行操作
• 插件支持：原生支持Fabric8 Maven插件（容器化部署）、Google Jib插件（构建OCI镜像）及TestContainers（容器化集成测试）
• 兼容性：与标准Maven镜像接口兼容，可无缝替换常规Maven镜像使用

使用场景

• Maven项目的容器化构建流程（如使用Jib插件直接构建Docker镜像）
• 基于TestContainers的集成测试（需Docker环境支持的测试场景）
• 使用Fabric8插件进行Kubernetes应用部署的构建流程
• 需要在构建过程中执行Docker命令的CI/CD流水线

使用方法与配置说明

基本使用（docker run）

bash
docker run --rm -v /var/run/docker.sock:/var/run/docker.sock -v "$(pwd)":/app -w /app maven/x.y.z-eclipse-temurin-zz mvn clean package

说明：需挂载宿主Docker socket（/var/run/docker.sock）以实现容器内Docker命令与宿主Docker引擎的通信

Docker Compose配置示例

yaml
version: '3.8'
services:
  maven-build:
    image: maven/x.y.z-eclipse-temurin-zz
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./:/app
    working_dir: /app
    command: mvn clean jib:build

插件使用示例

Google Jib插件配置（pom.xml）

xml
<plugin>
  <groupId>com.google.cloud.tools</groupId>
  <artifactId>jib-maven-plugin</artifactId>
  <version>3.3.1</version>
  <configuration>
    <to>
      <image>my-app:latest</image>
    </to>
  </configuration>
</plugin>

执行构建命令：

bash
docker run --rm -v /var/run/docker.sock:/var/run/docker.sock -v "$(pwd)":/app -w /app maven/x.y.z-eclipse-temurin-zz mvn jib:build

TestContainers使用示例

在测试类中直接使用TestContainers注解：

java
import org.testcontainers.containers.PostgreSQLContainer;
import org.testcontainers.junit.jupiter.Container;
import org.testcontainers.junit.jupiter.Testcontainers;

@Testcontainers
public class DatabaseTest {
    @Container
    static PostgreSQLContainer<?> postgres = new PostgreSQLContainer<>("postgres:14")
            .withDatabaseName("testdb")
            .withUsername("test")
            .withPassword("test");
    
    // 测试逻辑...
}

执行测试命令：

bash
docker run --rm -v /var/run/docker.sock:/var/run/docker.sock -v "$(pwd)":/app -w /app maven/x.y.z-eclipse-temurin-zz mvn test

注意事项

• 必须挂载宿主Docker socket（/var/run/docker.sock）才能使容器内Docker命令正常工作
• 确保宿主环境已安装Docker引擎并运行
• 镜像版本中的x.y.z对应Maven版本，zz对应JDK版本（如17、11等），使用时需替换为具体版本号