nutickets/nurunner

测试运行器Docker镜像文档

镜像概述

本Docker镜像专为测试任务执行设计，提供标准化、隔离的测试环境，旨在消除"在我机器上能运行"的环境一致性问题。通过容器化方式封装测试所需的运行时、依赖库及工具链，确保测试在不同环境中具有一致的执行结果，简化自动化测试流程的搭建与维护。

核心功能和特性

标准化测试环境

• 预配置常用测试工具链及依赖，确保测试执行环境的一致性
• 基于稳定基础镜像构建，版本控制明确，避免环境漂移

多测试框架支持

• 兼容主流测试框架（如JUnit、pytest、Mocha、Jest等）
• 可通过配置扩展支持自定义测试工具链

易于集成与扩展

• 轻量级设计，启动快速，资源占用低
• 支持与主流CI/CD工具（Jenkins、GitHub Actions、GitLab CI等）无缝集成
• 可通过环境变量和挂载卷自定义测试行为

资源隔离与安全

• 测试任务在独立容器中执行，避免对宿主环境造成污染
• 支持资源限制配置（CPU、内存），防止测试任务过度占用系统资源

使用场景和适用范围

开发阶段本地测试

• 开发人员本地验证代码功能，无需在本地搭建复杂测试环境
• 快速复现同僚报告的测试环境问题

CI/CD流水线集成

• 作为自动化测试环节的执行环境，确保流水线中测试结果的一致性
• 支持并行测试任务执行，提升CI/CD效率

自动化测试套件执行

• 定期执行自动化测试套件，生成标准化测试报告
• 跨平台测试验证（可配合多架构基础镜像实现）

使用方法和配置说明

基本使用命令

bash
docker run -v $(pwd)/test-code:/test \
  -v $(pwd)/test-reports:/reports \
  test-runner:latest \
  --framework <测试框架> \
  --test-path /test \
  --report-path /reports

参数说明

环境变量配置

数据卷挂载说明

CI/CD集成示例（GitHub Actions）

yaml
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
      
      - name: Run tests with test-runner
        run: |
          docker run -v $(pwd)/tests:/test \
            -v $(pwd)/reports:/reports \
            -e TEST_ENV=ci \
            -e LOG_LEVEL=DEBUG \
            test-runner:latest \
            --framework pytest \
            --test-path /test \
            --report-path /reports
      
      - name: Upload test reports
        uses: actions/upload-artifact@v3
        with:
          name: test-reports
          path: reports/

自定义测试框架配置

如需使用镜像未预安装的测试框架，可通过构建自定义Dockerfile扩展基础镜像：

dockerfile
FROM test-runner:latest

# 安装自定义测试框架（以Cypress为例）
RUN npm install -g cypress

# 设置默认框架为Cypress
ENV DEFAULT_FRAMEWORK=cypress

构建命令：docker build -t custom-test-runner:latest .