CI测试专用Docker镜像文档

一、镜像概述与主要用途

概述

本镜像是专为持续集成（CI）测试场景设计的轻量级Docker镜像，旨在提供标准化、可复用的自动化测试环境，支持各类测试流程的无缝集成与高效执行。

主要用途

• 作为CI/CD流水线中的测试执行环境，自动化运行单元测试、集成测试等流程
• 消除测试环境差异导致的"本地通过，CI失败"问题
• 简化多项目、多团队共享测试工具链的配置流程
• 快速集成至主流CI平台（如Jenkins、GitLab CI、GitHub Actions等）

二、核心功能与特性

1. 轻量级基础
   基于Alpine或Debian Slim构建，镜像体积小（<500MB），启动速度快，降低CI流程资源消耗。

2. 预装测试工具链
   集成主流测试框架与工具，包括：

   • 单元测试：JUnit 5（Java）、pytest（Python）、Jest（JavaScript）
   • 测试报告生成：Allure、Cobertura、JUnit XML
   • 环境依赖：Git、curl、wget、常用编译工具链

3. 多语言支持
   内置Python 3.9+、OpenJDK 17、Node.js 18+运行时环境，支持跨语言项目测试。

4. CI平台兼容性
   适配主流CI/CD系统的任务调度机制，支持非交互式运行、后台执行与结果返回。

5. 可定制化配置
   通过环境变量、配置文件或命令行参数灵活调整测试行为，支持自定义测试脚本与报告输出。

三、使用场景与适用范围

适用场景

• 自动化单元测试：在代码提交后自动运行单模块测试，快速反馈质量问题
• 集成测试环境：模拟服务依赖（如数据库、消息队列），验证模块间交互
• CI/CD流水线集成：作为流水线中的测试阶段，与构建、部署环节串联
• 多项目共享测试环境：统一团队测试工具版本，减少重复配置

适用范围

• 中小型软件开发团队的自动化测试流程
• 支持Java/Python/JavaScript为主的项目测试
• 需要快速迭代的敏捷开发场景
• 对测试环境一致性要求高的场景

四、使用方法与配置说明

4.1 基本使用（docker run）

通过以下命令启动容器并执行测试：

docker run -it --rm \
  -v $(pwd)/test-code:/app  `# 挂载本地测试代码到容器内/app目录` \
  -v $(pwd)/test-reports:/reports  `# 挂载报告输出目录` \
  -e TEST_FRAMEWORK=pytest  `# 指定测试框架（可选值：pytest/junit/jest）` \
  -e TEST_TIMEOUT=300  `# 设置测试超时时间（秒，默认300）` \
  ci-test-image:latest  `# 镜像名称:版本` \
  sh -c "cd /app && run-tests"  `# 执行测试命令`

参数说明

• -v $(pwd)/test-code:/app：挂载本地测试代码目录至容器内/app（测试执行根目录）
• -v $(pwd)/test-reports:/reports：挂载测试报告输出目录（容器内报告默认写入/reports）
• -e TEST_FRAMEWORK：指定测试框架，未设置时自动检测项目类型

4.2 Docker Compose 配置

适用于需要依赖服务（如数据库、Redis）的集成测试场景：

version: '3.8'
services:
  test-runner:
    image: ci-test-image:latest
    volumes:
      - ./test-code:/app          # 测试代码目录
      - ./test-reports:/reports   # 测试报告输出
    environment:
      - TEST_FRAMEWORK=pytest
      - TEST_TIMEOUT=600          # 集成测试超时设为10分钟
      - DB_HOST=mysql             # 依赖服务地址（通过Docker网络互通）
      - DB_PORT=3306
    depends_on:
      - mysql                     # 等待依赖服务启动

  # 依赖服务示例（MySQL）
  mysql:
    image: mysql:8.0
    environment:
      - MYSQL_ROOT_PASSWORD=testpass
      - MYSQL_DATABASE=testdb
    ports:
      - "3306:3306"

启动命令：

docker-compose up --build test-runner  # 仅启动测试服务及依赖

五、配置参数详解

5.1 环境变量

5.2 卷挂载

5.3 命令行参数

通过docker run命令末尾追加参数调整测试行为：

六、注意事项

1. 权限问题
   挂载本地目录时，若容器内用户（默认ci-user，UID=1000）无读写权限，可通过-u $(id -u):$(id -g)参数指定当前用户ID：

   docker run -u $(id -u):$(id -g) -v ./test-code:/app ...
   

2. 测试依赖安装
   若项目需额外依赖（如Python包、Node模块），可在测试代码目录中添加requirements.txt或package.json，容器启动时会自动执行pip install或npm install。

3. 镜像版本选择
   生产环境建议使用固定版本标签（如ci-test-image:1.2.0），避免最新版（latest）更新导致兼容性问题。

4. 资源限制
   在CI平台中运行时，建议通过--memory=2g --cpus=1限制资源使用，避免影响其他任务：

   docker run --memory=2g --cpus=1 ...