bsisoftware/scout-maven-chrome

JIRO build maven 镜像文档

镜像概述

JIRO build maven 镜像是一个集成Maven环境的Docker镜像，基于Jiro项目构建，旨在简化Java项目的构建流程。该镜像内置Maven运行环境，无需在本地安装Maven即可执行项目编译、打包、依赖管理等操作，适用于开发环境快速构建及CI/CD流程中的自动化构建场景。

核心功能与特性

• 内置Maven环境：预配置Maven运行环境，支持标准Maven命令（如mvn clean、mvn package、mvn install等）
• 跨环境一致性：提供统一的构建环境，避免因本地Maven版本、配置差异导致的构建结果不一致问题
• 轻量级设计：优化镜像体积，减少资源占用，提升构建效率
• 灵活挂载支持：支持挂载本地项目目录及自定义Maven配置文件（如settings.xml）
• 依赖缓存机制：缓存Maven依赖，减少重复下载，加速后续构建过程

使用场景

• 本地开发构建：开发人员无需本地安装Maven，直接通过容器快速构建Java项目
• CI/CD自动化流程：作为CI/CD流水线中的构建环节基础镜像，实现自动化编译、打包
• 多版本兼容测试：通过指定不同标签的镜像，测试项目在不同Maven版本下的构建兼容性
• 临时项目构建：快速搭建临时构建环境，完成项目演示或紧急打包需求

使用方法

基本构建命令

通过挂载本地项目目录到容器内工作目录，执行Maven构建命令：

bash
docker run -v /本地项目路径:/app jiro-build-maven mvn clean package

参数说明：

• -v /本地项目路径:/app：将本地Java项目根目录挂载到容器内/app目录（容器默认工作目录）
• mvn clean package：执行Maven清理并打包命令（可替换为其他Maven命令，如mvn install、mvn test等）

自定义Maven配置

如需使用自定义settings.xml（如配置私有仓库），可挂载本地配置文件至容器Maven配置目录：

bash
docker run \
  -v /本地项目路径:/app \
  -v /本地settings.xml路径:/usr/share/maven/conf/settings.xml \
  jiro-build-maven mvn clean package

指定Maven运行参数

通过MAVEN_OPTS环境变量设置JVM参数（如内存配置）：

bash
docker run \
  -e MAVEN_OPTS="-Xmx1024m -XX:MaxPermSize=256m" \
  -v /本地项目路径:/app \
  jiro-build-maven mvn clean package

持久化依赖缓存

为避免每次构建重复下载依赖，可挂载Maven本地仓库目录到容器，实现依赖缓存持久化：

bash
docker run \
  -v /本地项目路径:/app \
  -v /本地maven仓库路径:/root/.m2/repository \
  jiro-build-maven mvn clean package

环境变量说明

注意事项

• 确保本地项目目录具备读写权限，避免容器因权限不足导致构建失败
• 首次构建时，Maven会下载项目依赖，耗时较长；后续构建将利用缓存加速
• 如需指定特定Maven版本，可通过镜像标签选择（如jiro-build-maven:3.8.6）
• 构建产物（如target目录）将生成在本地项目目录中，与容器内同步

示例：构建Spring Boot项目

1. 本地Spring Boot项目路径：/home/user/my-springboot-project
2. 执行打包命令：

bash
docker run -v /home/user/my-springboot-project:/app jiro-build-maven mvn clean package -DskipTests

3. 构建完成后，在本地项目target目录下获取打包产物（如my-springboot-project-0.0.1-SNAPSHOT.jar）