E2E测试CI专用镜像文档

镜像概述

本镜像专为CI/CD环境设计，提供端到端(e2e)测试所需的完整运行环境与工具链。通过预集成主流e2e测试框架及依赖组件，旨在简化CI流程中的测试环节，帮助开发团队在应用部署前快速完成从用户界面到后端服务的全链路功能验证，提升交付质量。

核心功能与特性

• 预配置测试环境：内置常用e2e测试工具（如Cypress、Playwright、Selenium等）及浏览器驱动（Chrome、Firefox），无需手动安装依赖
• 轻量级基础：基于Alpine或Debian Slim构建，镜像体积小，减少CI资源占用和拉取时间
• CI兼容性：适配主流CI平台（GitHub Actions、GitLab CI、Jenkins、CircleCI等），支持容器化测试任务调度
• 测试报告支持：集成报告生成工具，可输出JUnit、HTML等格式测试报告，便于CI平台解析和展示结果
• 环境隔离：独立容器环境确保测试过程不受CI宿主环境干扰，结果可重复

使用场景与适用范围

• Web应用e2e测试：适用于前后端分离架构的Web应用，验证用户交互流程（如登录、表单提交、页面跳转等）
• CI流程集成：嵌入CI/CD流水线（如部署前的测试阶段），作为自动化测试环节的执行环境
• 多环境验证：支持通过环境变量配置测试目标（开发/测试/预发布环境），验证不同环境下的应用表现
• 团队协作：统一测试环境，避免"本地测试通过，CI测试失败"的环境差异问题

使用方法与配置说明

基础使用（Docker Run）

通过挂载测试代码目录并指定测试命令执行：

bash
# 示例：使用Cypress执行测试
docker run --rm \
  -v $(pwd)/tests:/app/tests \  # 挂载本地测试代码目录
  -v $(pwd)/reports:/app/reports \  # 挂载测试报告输出目录
  -e TEST_URL=[***] \  # 测试目标应用URL
  -e TEST_FRAMEWORK=cypress \  # 指定测试框架（cypress/playwright/selenium）
  e2e-test-ci-image \
  cypress run --spec /app/tests/e2e/**/*.spec.js

CI配置示例（GitHub Actions）

在.github/workflows/test.yml中集成：

yaml
jobs:
  e2e-test:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
      
      - name: Run e2e tests
        uses: docker://e2e-test-ci-image:latest
        with:
          args: cypress run --spec /app/tests/e2e/main.spec.js
        env:
          TEST_URL: ${{ secrets.TEST_APP_URL }}
          TEST_TIMEOUT: 300  # 测试超时时间（秒）
          REPORT_PATH: /app/reports  # 报告输出路径

环境变量配置

注意事项

• 测试代码需与镜像支持的测试框架版本兼容，建议在项目文档中注明依赖的框架版本
• 敏感信息（如测试环境凭证）建议通过CI平台的secret机制注入，避免硬编码在镜像或测试代码中
• 如需自定义测试工具版本，可基于本镜像构建新镜像并覆盖对应依赖
• 高并发测试场景建议调整容器CPU/内存资源限制，避免测试超时或失败