noenv/maven

docker-maven

https://github.com/NoEnv/docker-maven/actions/workflows/build.yml/badge.svg](https://github.com/NoEnv/docker-maven/actions/workflows/build.yml)

镜像概述

docker-maven是一个集成Maven的Docker镜像，旨在提供便捷的容器化Maven运行环境。该镜像封装了Maven工具，支持在隔离的容器环境中执行项目构建、依赖管理及生命周期管理等操作，适用于标准化开发流程和自动化构建场景。

核心功能与特性

• 完整Maven功能：支持Maven标准项目构建流程，包括编译、测试、打包（JAR/WAR等）、部署等生命周期阶段。
• 依赖管理：自动解析项目依赖，从Maven仓库下载并缓存依赖包，确保依赖版本一致性。
• 容器化隔离：提供独立的构建环境，避免主机系统依赖冲突，确保构建环境一致性。
• 轻量集成：可快速集成到CI/CD流水线，简化自动化构建配置。

使用场景

• 统一开发环境：为团队提供一致的Maven运行环境，消除本地环境差异导致的构建问题。
• CI/CD自动化：在持续集成/部署流程中作为构建步骤容器，自动完成项目编译、测试和打包。
• 多版本兼容：通过不同标签的镜像（如指定Maven版本），满足不同项目对Maven版本的需求。

使用方法与配置说明

基本使用示例

通过docker run命令直接执行Maven命令：

bash
# 查看Maven版本信息
docker run --rm noenv/maven mvn --version

# 构建当前目录下的Maven项目（clean + install）
docker run --rm -v "$(pwd)":/project -w /project noenv/maven mvn clean install

关键挂载配置

1. 项目目录挂载

将主机项目目录挂载到容器内，使Maven可访问项目文件：

bash
-v "$(pwd)":/project  # 将主机当前目录挂载到容器内/project目录
-w /project            # 设置容器工作目录为/project

2. 依赖缓存挂载

为避免重复下载依赖，挂载Maven本地仓库目录（缓存依赖）：

bash
-v "$HOME/.m2/repository":/root/.m2/repository  # 挂载主机Maven仓库到容器

环境变量配置

通过-e参数设置环境变量，自定义Maven行为：

示例：

bash
docker run --rm -e "MAVEN_OPTS=-Xmx1024m" noenv/maven mvn clean package

Docker Compose配置示例

在docker-compose.yml中集成镜像：

yaml
version: '3.8'
services:
  maven-build:
    image: noenv/maven
    volumes:
      - ./:/project                # 挂载项目目录
      - ~/.m2/repository:/root/.m2/repository  # 挂载依赖缓存
    working_dir: /project
    command: mvn clean package -DskipTests  # 执行构建（跳过测试）

注意事项

• 权限问题：确保挂载的主机目录具有读写权限，避免容器内文件操作失败。
• 镜像标签：通过指定标签选择Maven版本（如noenv/maven:3.9.6），具体版本可参考https://hub.docker.com/r/noenv/maven/tags%E3%80%82
• 网络配置：如需访问私有Maven仓库，确保容器网络可连接仓库地址（必要时配置代理）。