hsldevcom/jore4-cypress

JORE4系统Cypress端到端测试镜像

镜像概述

本Docker镜像专为JORE4系统设计，集成Cypress端到端测试框架，提供开箱即用的自动化测试环境。通过容器化方式封装测试依赖和执行逻辑，简化JORE4系统的测试流程，确保系统在开发、测试及部署各阶段的功能正确性和稳定性验证。

核心功能和特性

• 预配置Cypress环境：已集成指定版本的Cypress及必要依赖（Node.js、浏览器驱动等），无需手动安装配置。
• 灵活的测试配置：支持通过环境变量或挂载配置文件自定义测试参数（如目标URL、测试超时时间等）。
• 测试报告生成：内置报告模块，支持生成HTML、JUnit XML等格式测试报告，便于结果分析和CI/CD集成。
• 多环境适配：可通过参数指定测试目标环境（开发、测试、预生产等），适应不同阶段验证需求。
• 轻量级基础：基于Alpine或Debian Slim基础镜像，减少镜像体积，提升部署和执行效率。

使用场景和适用范围

• 开发阶段本地测试：开发人员在本地环境快速运行测试，验证代码变更对系统功能的影响。
• CI/CD流水线集成：作为自动化测试环节嵌入CI/CD流程，在代码提交或部署前自动执行测试，拦截功能异常。
• 多环境一致性验证：在开发、测试、预生产等不同环境中执行相同测试用例，确保环境差异不影响系统功能。
• 回归测试执行：定期或触发式执行全量测试用例，验证系统迭代过程中是否引入回归问题。

使用方法和配置说明

基本使用（Docker Run）

通过docker run命令直接执行测试，需挂载本地测试文件目录至容器内指定路径：

bash
docker run -it --rm \
  -v $(pwd)/cypress:/app/cypress \          # 挂载本地测试用例目录
  -v $(pwd)/cypress.json:/app/cypress.json  # 挂载Cypress配置文件（可选）
  -v $(pwd)/reports:/app/reports            # 挂载测试报告输出目录
  -e TARGET_URL="https://jore4-test.example.com"  # 指定测试目标系统URL
  jore4-cypress-tests:latest                # 镜像名称及标签
  npx cypress run                           # 执行测试命令

Docker Compose配置

创建docker-compose.yml文件，定义测试服务及依赖：

yaml
version: '3.8'
services:
  cypress-test:
    image: jore4-cypress-tests:latest
    volumes:
      - ./cypress:/app/cypress           # 本地测试用例目录
      - ./cypress.config.js:/app/cypress.config.js  # Cypress配置文件
      - ./reports:/app/reports           # 测试报告输出
    environment:
      - TARGET_URL=https://jore4-dev.example.com  # 测试目标URL
      - CYPRESS_BASE_URL=${TARGET_URL}   # Cypress基础URL（通常与TARGET_URL一致）
      - REPORT_FORMAT=html,junit         # 测试报告格式（默认html）
      - TEST_TIMEOUT=30000               # 测试超时时间（毫秒，默认30000）
    command: npx cypress run --spec "cypress/e2e/**/*.cy.js"  # 指定测试文件路径

启动测试：

bash
docker-compose up

环境变量配置

测试报告查看

测试执行完成后，报告文件将生成在REPORT_DIR指定的目录（默认/app/reports）。若通过-v参数挂载本地目录（如示例中的$(pwd)/reports:/app/reports），可在本地访问：

• HTML报告：打开reports/html/index.html
• JUnit XML报告：查看reports/junit/test-results.xml（用于CI/CD系统集成）

注意事项

• 目标系统可访问性：确保容器网络能访问TARGET_URL指定的JORE4系统（本地测试建议使用--network=host或配置容器网络）。
• 测试文件权限：挂载本地测试文件时，确保文件权限允许容器内用户读取（建议设置文件权限为644，目录权限为755）。
• 资源配置：Cypress测试需一定CPU和内存资源，建议为容器分配至少2GB内存（通过--memory=2g参数）。
• 版本兼容性：镜像标签应与JORE4系统版本匹配，避免因系统接口变更导致测试失败。