allocateengineering/cypress

Cypress基础镜像（含aws、jq、curl等工具）

镜像概述

本镜像基于轻量级Linux环境构建，预安装了Cypress基础运行环境，并集成了aws CLI、jq、curl等常用工具，旨在为前端自动化测试提供一站式运行环境，减少测试环境配置复杂度，提升开发与CI/CD流程效率。

核心功能与特性

• Cypress基础环境：预安装最新稳定版Cypress，包含测试运行所需的依赖库（如Node.js、浏览器驱动等）
• AWS工具集成：内置AWS CLI，支持与AWS云服务（如S3、Lambda等）进行交互
• JSON处理工具：集成jq，可高效解析、过滤和转换JSON数据
• 网络请求工具：包含curl，支持HTTP/HTTPS请求发送与响应处理
• 通用工具集：附带git、wget、unzip等基础工具，满足日常测试流程需求

使用场景与适用范围

• 前端自动化测试：作为Cypress测试脚本的运行容器，支持UI测试、API测试等场景
• CI/CD流程集成：嵌入Jenkins、GitLab CI等持续集成系统，执行自动化测试步骤
• AWS环境测试：需与AWS服务交互的测试任务（如资源上传、测试数据拉取等）
• 数据处理场景：结合jq处理API返回的JSON数据，验证接口响应格式

使用方法与配置说明

基本使用（docker run）

1. 启动交互式终端

bash
docker run -it --rm [镜像名称] /bin/bash

进入容器后可直接使用cypress run执行测试脚本

2. 运行本地测试文件

将本地Cypress测试项目挂载至容器内执行：

bash
docker run -it --rm -v $(pwd):/app [镜像名称] \
  sh -c "cd /app && cypress run --spec cypress/e2e/example.cy.js"

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  cypress-test:
    image: [镜像名称]
    volumes:
      - ./cypress:/app/cypress        # 挂载测试用例目录
      - ./cypress.config.js:/app/cypress.config.js  # 挂载Cypress配置文件
    command: ["cypress", "run", "--browser", "chrome"]

启动服务：

bash
docker-compose up

环境变量配置

本镜像无需特殊环境变量，若需自定义Cypress行为，可通过挂载cypress.config.js文件或命令行参数调整（如--browser指定浏览器、--headed启用可视化界面等）。

与AWS服务交互示例

在容器内使用AWS CLI配置凭证并执行操作：

bash
# 配置AWS凭证（需提前准备access key与secret）
aws configure
# 示例：从S3下载测试数据
aws s3 cp s3://test-bucket/test-data.json /app/test-data.json
# 使用jq解析下载的JSON文件
jq '.results[] | select(.status=="pass")' /app/test-data.json

注意事项

• 容器默认以非root用户运行，若需权限操作，可通过--user root参数调整
• 如需持久化测试报告，建议将报告目录（如cypress/reports）挂载至宿主机
• 浏览器支持：默认包含Chromium浏览器，如需Firefox等其他浏览器，需额外安装对应驱动