主分支构建镜像

镜像概述和主要用途

本镜像专为软件项目的主分支构建流程设计，基于主分支最新代码构建，集成了项目构建、测试所需的完整依赖环境及配置。主要用于简化主分支版本的构建流程，支持开发者和CI/CD系统快速获取主分支最新代码并执行构建、测试或部署操作，确保主分支版本的一致性和可靠性。

核心功能和特性

• 主分支代码同步：内置主分支最新提交代码，确保使用最新稳定版本进行构建
• 完整依赖集成：包含项目构建、测试所需的所有依赖工具和库，无需额外安装
• 标准化构建流程：支持项目默认构建命令，可直接执行编译、打包等操作
• 轻量级设计：基于精简基础镜像构建，减少镜像体积，提升运行效率
• 环境一致性：统一构建环境，避免因本地环境差异导致的"在我电脑上能运行"问题

使用场景和适用范围

• CI/CD流程集成：作为持续集成/持续部署管道的构建节点，自动执行主分支代码的构建和测试
• 本地开发测试：开发者在本地快速搭建主分支构建环境，验证代码合并到主分支后的效果
• 主分支版本发布：用于生成主分支正式版本的构建产物，支持后续部署流程
• 多环境一致性验证：在开发、测试、预发布等不同环境中使用相同镜像，确保构建结果一致

使用方法和配置说明

基本使用命令

通过以下命令启动镜像并执行默认构建流程：

bash
docker run --rm [镜像名称]:latest

挂载本地代码目录（可选）

如需使用本地修改后的主分支代码（而非镜像内置代码），可挂载本地代码目录至镜像的/app路径：

bash
docker run --rm -v /本地主分支代码目录:/app [镜像名称]:latest

指定自定义构建命令

如需执行非默认构建命令，可在运行时指定命令参数：

bash
# 执行测试命令示例
docker run --rm [镜像名称]:latest npm test

# 执行打包命令示例
docker run --rm [镜像名称]:latest mvn package -DskipTests

环境变量配置

支持通过环境变量自定义构建行为，常用环境变量说明：

示例：设置构建产物输出目录并跳过测试

bash
docker run --rm -e BUILD_OUTPUT_DIR=/app/build -e SKIP_TESTS=true [镜像名称]:latest

持久化构建产物

如需保存构建产物，可将输出目录挂载到本地：

bash
docker run --rm -v /本地输出目录:/app/dist [镜像名称]:latest

执行完成后，构建产物将保存至本地/本地输出目录。

注意事项

• 确保本地代码目录已切换至主分支（git checkout master/main），避免挂载非主分支代码导致构建异常
• 自定义命令需符合项目构建规范，建议先在本地验证命令有效性
• 如需使用私有依赖，需通过环境变量（如-e NPM_REGISTRY=私有仓库地址）配置镜像内的依赖源