cumuluss/cumulus-build-env

Cumulus单元测试构建环境镜像

镜像概述

本镜像为Cumulus项目提供专用的本地构建环境，旨在简化单元测试的执行流程。通过预配置必要的依赖和工具链，确保开发者可在隔离环境中快速运行Cumulus单元测试，验证代码功能和稳定性。

核心功能与特性

• 预配置依赖环境：内置Cumulus单元测试所需的全部依赖组件，无需手动安装
• 隔离测试空间：通过容器化环境避免本地开发环境与测试环境的依赖冲突
• 完整工具链支持：包含单元测试执行、结果收集及日志输出的必要工具
• 快速启动能力：简化测试流程，支持一键启动并执行测试命令

使用场景与适用范围

• Cumulus项目开发者在本地开发阶段执行单元测试验证代码正确性
• 代码提交前的本地测试预检查，降低CI/CD流程中的失败风险
• 多版本并行开发时，为不同分支提供独立的测试环境
• 新人开发者快速上手项目测试流程，无需复杂的本地环境配置

使用方法与配置说明

基本运行命令

通过docker run命令启动测试环境，挂载本地Cumulus项目目录至容器工作区：

bash
docker run -v /本地/cumulus项目路径:/workspace docker.xuanyuan.run/cumulus-test-env:latest [测试命令]

参数说明：

• /本地/cumulus项目路径：本地Cumulus源代码目录的绝对路径
• [测试命令]：Cumulus项目单元测试执行命令（如npm run test、pytest等，需与项目测试框架匹配）

数据卷挂载配置

为持久化测试结果，可额外挂载测试输出目录：

bash
docker run \
  -v /本地/cumulus项目路径:/workspace \
  -v /本地/测试结果目录:/test-results \
  docker.xuanyuan.run/cumulus-test-env:latest \
  [测试命令] --output=/test-results

环境变量（可选）

目前无需特殊环境变量配置。如需自定义测试行为，可通过项目自身的配置文件或测试命令参数实现。

常见操作示例

1. 执行默认单元测试：

   bash
   docker run -v ~/projects/cumulus:/workspace docker.xuanyuan.run/cumulus-test-env:latest npm test
   

2. 指定测试文件：

   bash
   docker run -v ~/projects/cumulus:/workspace docker.xuanyuan.run/cumulus-test-env:latest pytest tests/unit/utils_test.py
   

3. 查看测试环境信息：

   bash
   docker run --rm docker.xuanyuan.run/cumulus-test-env:latest env
   

注意事项

• 确保本地Docker环境已正确安装并运行
• 挂载目录需具有适当的读写权限，避免容器内权限错误
• 测试命令需与Cumulus项目实际使用的测试框架保持一致
• 如遇依赖版本冲突，可通过项目issue反馈或提交定制化环境需求