端到端测试环境Docker镜像文档

概述

本Docker镜像专为端到端（E2E）测试场景设计，集成主流测试工具与运行环境，无需手动配置依赖，可快速搭建标准化测试环境。镜像通过预封装测试框架、浏览器驱动及报告工具，降低测试环境搭建复杂度，支持从界面交互到接口调用的全链路验证，适用于开发团队、测试团队及CI/CD流程的自动化测试需求。

核心功能

1. 工具集成

• 内置主流E2E测试框架：Selenium、Cypress、Playwright等
• 集成浏览器驱动：Chrome、Firefox、Edge等主流浏览器支持
• 测试辅助工具：测试报告生成器（Allure）、日志收集工具、环境变量管理模块

2. 环境兼容性

• 支持Linux/Windows/macOS宿主机系统
• 兼容Docker Desktop及服务器端Docker引擎（Docker Engine 20.10+）
• 适配Kubernetes集群部署（需配合StatefulSet资源）

3. 自动化与集成能力

• 原生支持Jenkins、GitLab CI、GitHub Actions等CI/CD平台
• 提供REST API接口用于测试任务调度
• 支持测试结果JSON/HTML格式导出，可对接第三方报告系统

4. 轻量级设计

• 基础镜像基于Alpine Linux，压缩后体积≤300MB
• 采用多阶段构建优化，仅保留运行时必要依赖
• 支持按需加载测试模块（通过环境变量控制）

使用场景

1. 开发阶段本地测试

开发人员可通过本镜像在本地快速复现测试环境，验证前端交互逻辑、后端接口调用及数据流转的完整性，无需手动配置复杂依赖。

2. CI/CD流程自动化测试

在代码合并或发布前，通过CI/CD平台触发镜像部署，自动执行预设测试用例，生成测试报告并阻断异常流程，确保交付质量。

3. 多环境一致性验证

针对开发、测试、预发布等不同环境，通过镜像标准化测试配置，避免因环境差异导致的测试结果不一致问题。

4. 团队协作测试环境共享

团队成员可通过统一镜像版本共享测试环境配置，减少"本地可测，线上失败"的协作问题，提升团队测试效率。

使用方法

基础部署（Docker Run）

bash
# 拉取镜像（假设镜像名为e2e-test-env，具体名称需替换为实际镜像地址）
docker pull [镜像仓库地址]/e2e-test-env:latest

# 启动测试环境（默认启动Cypress框架，暴露8080端口用于Web控制台）
docker run -d \
  --name e2e-test \
  -p 8080:8080 \
  -v ./test-cases:/app/test-cases \  # 挂载本地测试用例目录
  -v ./test-reports:/app/reports \  # 挂载测试报告输出目录
  -e TEST_TARGET_URL="[***]" \  # 测试目标应用URL
  -e TEST_FRAMEWORK="cypress" \  # 指定测试框架（可选：selenium/playwright/cypress）
  [镜像仓库地址]/e2e-test-env:latest

Docker Compose部署

创建docker-compose.yml文件：

yaml
version: '3.8'
services:
  e2e-test:
    image: [镜像仓库地址]/e2e-test-env:latest
    container_name: e2e-test
    ports:
      - "8080:8080"  # Web控制台端口
      - "4444:4444"  # Selenium Grid端口（如启用Selenium）
    volumes:
      - ./test-cases:/app/test-cases:ro  # 只读挂载测试用例
      - ./test-reports:/app/reports:rw  # 读写挂载报告目录
      - ./browser-cache:/app/.cache  # 持久化浏览器缓存（可选）
    environment:
      - TEST_TARGET_URL="[***]"  # 必选：测试目标URL
      - TEST_FRAMEWORK="playwright"  # 可选：测试框架类型
      - BROWSER_TYPE="chrome"  # 可选：浏览器类型（chrome/firefox/edge）
      - REPORT_FORMAT="html,json"  # 可选：报告输出格式（多格式用逗号分隔）
      - TEST_TIMEOUT=300  # 可选：测试超时时间（秒，默认300）
    restart: unless-stopped

启动命令：docker-compose up -d

测试执行与结果查看

1. 访问Web控制台：http://localhost:8080，通过界面配置测试任务或直接执行挂载的测试用例
2. 测试报告默认输出至./test-reports目录，可通过浏览器打开index.html查看可视化报告
3. 日志查看：docker logs -f e2e-test

配置参数

环境变量配置

目录挂载说明

注意事项

1. 测试用例需符合指定框架语***范（如Cypress需使用.spec.js文件），否则可能导致执行失败
2. 若测试目标应用部署在本地宿主机，容器内访问地址需使用宿主机IP（如host.docker.internal）而非localhost
3. 高并发测试场景建议调整容器CPU/内存限制（通过--cpus和-m参数），避免资源不足导致测试超时
4. 镜像默认不持久化测试数据，需通过目录挂载保留关键测试结果（报告、截图等）