drydockcloud/ci-cypress

Drydock CI Cypress

镜像概述

Drydock CI Cypress是一个遵循Drydock模式的Cypress.io镜像，当前状态为alpha。该镜像旨在提供标准化的Cypress测试环境，简化Cypress自动化测试的部署与执行流程，适用于CI/CD流水线及本地开发环境。

核心功能

• 初始配置支持：可直接使用仓库中的cypress.json作为测试的初始配置文件。
• 测试目标指定：通过TARGET环境变量灵活定义测试目标。
• 目录挂载机制：
  • 需将包含cypress.json的Cypress根目录挂载至容器内/src目录（建议设置为只读模式），确保测试配置正确加载。
  • 需挂载/results目录，用于存储测试报告、截图、视频等工件。
• 交互式使用支持：支持交互式运行Cypress测试，需额外配置以允许X11访问（详情参考Cypress官方指南）。

使用场景

• CI/CD流水线中的自动化测试环节，通过标准化环境确保测试一致性。
• 本地开发环境中快速验证Cypress测试用例。
• 需要隔离测试依赖与配置的Cypress测试场景。

使用方法与配置说明

基础运行命令

bash
docker run -e TARGET=<测试目标> \
  -v <本地Cypress根目录路径>:/src:ro \
  -v <本地结果存储路径>:/results \
  drydock-ci-cypress

参数说明

环境变量

• TARGET：必填，用于指定测试目标，例如测试的应用URL或特定测试套件。

挂载目录

• /src：必填，挂载包含cypress.json的Cypress根目录，建议添加ro参数设置为只读，避免容器内配置被意外修改。
• /results：必填，挂载本地目录用于存储测试报告、截图、视频等输出工件。

交互式使用配置

如需以交互式模式运行（如打开Cypress图形界面），需配置X11访问权限，具体步骤可参考Cypress官方文档。典型配置示例（Linux环境）：

bash
docker run -e TARGET=<测试目标> \
  -v <本地Cypress根目录路径>:/src:ro \
  -v <本地结果存储路径>:/results \
  -v /tmp/.X11-unix:/tmp/.X11-unix \
  -e DISPLAY=$DISPLAY \
  drydock-ci-cypress