wendell023/maven

Maven镜像文档

镜像概述

本镜像基于官方Maven镜像优化构建，预配置阿里云Maven镜像源，解决国内网络环境下依赖下载缓慢问题。同时支持自定义settings.xml，满足个性化构建需求，适用于各类Maven项目的构建、打包等场景。

核心功能与特性

• 加速依赖下载：内置阿里云Maven镜像源，显著提升国内环境下的依赖拉取速度
• 自定义配置支持：可通过挂载自定义settings.xml文件，实现镜像源、代理等个性化配置
• 数据持久化：支持挂载本地Maven仓库目录，避免重复下载依赖，节省带宽和时间
• 轻量便捷：基于官方Maven精简优化，启动快速，易于集成到开发或CI/CD流程

使用场景

• 国内Maven项目开发环境搭建
• 快速部署临时Maven构建环境
• CI/CD流水线中的Maven构建环节
• 需要统一Maven配置的团队开发场景

使用方法

拉取镜像

bash
docker pull wendell023/maven

启动容器

基本构建命令（挂载当前项目目录和本地Maven仓库）：

bash
docker run -it --rm -v "$(pwd)":/app -w /app \
  -v /docker_volume/maven-repo:/usr/share/maven/ref/repository \
  wendell023/maven mvn clean package -DskipTests=true

参数说明：

• -it：以交互模式运行容器
• --rm：容器退出后自动删除
• -v "$(pwd)":/app：将当前目录挂载到容器内的/app目录，实现项目文件共享
• -w /app：设置容器工作目录为/app
• -v /docker_volume/maven-repo:/usr/share/maven/ref/repository：挂载本地Maven仓库目录，实现依赖缓存

自定义settings.xml

若需使用自定义settings.xml，可通过额外挂载配置文件实现：

bash
docker run -it --rm -v "$(pwd)":/app -w /app \
  -v /path/to/your/settings.xml:/usr/share/maven/ref/settings.xml \
  -v /docker_volume/maven-repo:/usr/share/maven/ref/repository \
  wendell023/maven mvn clean package

注意事项

• 本地Maven仓库目录（如/docker_volume/maven-repo）需提前创建，避免权限问题
• 自定义settings.xml需确保格式正确，否则可能导致Maven构建失败
• 如需持久化容器，可移除--rm参数，但建议配合数据卷使用以保证数据安全