conv/playwright

Cypress测试基础镜像

概述

该镜像为运行Cypress测试提供基础环境，仅包含Cypress所需的系统依赖和Node.js。设计目的是通过将实际测试文件挂载到/var/www/html目录运行，确保主机系统文件拥有正确权限。不可直接使用，需基于此镜像扩展后使用。

核心功能与特性

• 精简依赖：仅包含Cypress运行必需的系统依赖和Node.js，减少镜像体积
• 权限处理：通过指定用户运行，确保挂载的主机测试文件保持正确权限
• 挂载支持：默认工作目录为/var/www/html，支持外部测试文件挂载
• 扩展设计：作为基础镜像，需通过Dockerfile扩展以添加具体测试代码和项目依赖

使用场景与适用范围

适用于开发环境或CI/CD流程中构建自定义Cypress测试环境，尤其适合需要统一测试运行环境、确保文件权限一致性的场景。

使用方法与配置说明

扩展基础镜像

创建自定义Dockerfile扩展此基础镜像，添加项目依赖和测试代码：

dockerfile
# 基于Cypress基础镜像
FROM [基础镜像名称]

# 设置工作目录（已默认设置为/var/www/html，可省略）
WORKDIR /var/www/html

# 复制项目依赖文件并安装
COPY package.json package-lock.json ./
RUN npm install

# 复制测试代码
COPY cypress/ ./cypress/
COPY cypress.config.js ./

构建与运行

1. 构建自定义测试镜像：

   bash
   docker build -t custom-cypress-test .
   

2. 运行测试（如需动态挂载测试文件）：

   bash
   docker run -v /本地测试目录:/var/www/html custom-cypress-test cypress run
   

注意事项

• 禁止直接使用：该镜像仅作为基础镜像，直接运行无实际测试功能
• 权限管理：确保本地测试目录权限允许容器内用户访问，避免权限拒绝错误
• 依赖一致性：扩展时建议固定Node.js版本和Cypress版本，确保测试环境稳定