octoenergy/consumer-site-circle-docker

镜像概述

该镜像作为CircleCI测试运行的基础容器，旨在为CI/CD流程中的测试任务提供标准化、一致性的运行环境。它是CircleCI生态的核心组件之一，用于构建、执行各类测试任务（如单元测试、集成测试等），确保不同开发环境下测试结果的可靠性。

核心功能与特性

• 标准化测试环境：内置CircleCI测试所需的基础依赖和工具链，确保测试环境一致性，减少"在我机器上能运行"的问题。
• 兼容性支持：兼容CircleCI主流版本及常见测试框架，降低环境配置复杂度。
• 轻量级设计：优化镜像体积，减少拉取和启动时间，提升CI流程效率。
• 工具集成：默认集成常用测试工具（如代码覆盖率工具、日志收集工具等），简化测试任务配置。

使用场景与适用范围

• CircleCI测试任务执行：作为基础运行环境，支撑单元测试、集成测试、E2E测试等各类测试任务在CircleCI中的执行。
• 开发团队持续集成流程：适用于需要通过CircleCI实现自动化测试的开发团队，确保代码提交后快速触发并完成测试验证。
• 多环境一致性保障：在不同开发阶段（开发、测试、预发布）提供统一的测试环境，保障测试结果的可比性。

使用方法与配置说明### 基本使用

通过docker run命令启动容器，执行测试任务：

bash
docker run --rm -v /path/to/test/code:/workspace circleci/test-base:latest [test-command]

说明：/path/to/test/code为本地测试代码目录，通过挂载至容器/workspace目录，使容器可访问测试代码；[test-command]为具体测试命令（如npm test、pytest等）。

环境变量

该镜像支持通过环境变量配置测试行为，常用变量如下：

• TEST_ENV：指定测试环境类型（如development、testing），默认值：testing
• LOG_LEVEL：设置日志输出级别（info、debug、warn、error），默认值：info
• CACHE_DIR：指定测试依赖缓存目录，默认值：/workspace/.cache

示例（设置测试环境为开发环境）：

bash
docker run --rm -e TEST_ENV=development -v /path/to/test/code:/workspace circleci/test-base:latest npm test

配置参数

容器启动时可通过命令行参数调整行为：

• --no-cache：禁用依赖缓存，强制重新拉取测试依赖
• --report-path：指定测试报告输出路径，默认：/workspace/test-report

示例（禁用缓存并指定报告路径）：

bash
docker run --rm -v /path/to/test/code:/workspace circleci/test-base:latest --no-cache --report-path=/workspace/custom-report npm test