kucykoo/cypress-curl

cypress/included:13.13.1（含curl和AWS CLI）镜像文档

镜像概述和主要用途

本镜像基于官方cypress/included:13.13.1构建，是一个预配置的Cypress测试环境。在保留原镜像完整Cypress测试工具链的基础上，额外集成了curl（HTTP请求工具）和AWS CLI（Amazon Web Services命令行工具），并默认以非root用户1001身份运行。主要用途是为前端自动化测试提供开箱即用的环境，同时支持与AWS云服务的直接交互，适用于需要在测试流程中集成AWS资源操作的场景。

核心功能和特性

基础功能

• 完整Cypress测试环境：包含Cypress 13.13.1及所有依赖组件（Node.js、浏览器等），支持端到端测试、组件测试等Cypress核心功能。

新增工具

• curl：预装的HTTP客户端工具，支持GET/POST等HTTP请求，可用于测试流程中获取外部数据、触发API或健康检查。
• AWS CLI：预装的AWS命令行工具，支持与AWS服务（如S3、EC2、Lambda等）交互，可在测试前后管理AWS资源（如上传测试结果到S3、触发AWS测试环境部署等）。

安全特性

• 默认非root用户：镜像默认以用户ID 1001运行，避免以root权限执行测试流程，降低容器运行时的安全风险。

使用场景和适用范围

典型使用场景

1. 前端自动化测试集成AWS资源：在Cypress测试流程中，需通过AWS CLI操作S3存储桶（如上传测试截图、下载测试配置文件）或调用AWS Lambda函数的场景。
2. 依赖外部HTTP服务的测试：需通过curl工具获取外部API数据、触发第三方服务回调或验证HTTP端点可用性的Cypress测试。
3. CI/CD流水线中的测试环节：在持续集成流程中，提供一站式测试环境，无需额外安装Cypress、curl或AWS CLI依赖。

适用范围

• 前端开发团队的自动化测试环境
• 需要与AWS云服务集成的测试流程
• 对容器运行安全性有要求（非root用户）的场景

使用方法和配置说明

基本运行命令

直接启动测试

将本地测试代码目录挂载到容器内，直接运行Cypress测试：

shell
docker run --rm -v $(pwd):/e2e cypress/included:13.13.1 --user 1001

说明：-v $(pwd):/e2e 将当前目录（包含Cypress测试文件）挂载到容器内的/e2e目录（Cypress默认工作目录）；--rm 表示测试完成后自动删除容器。

集成AWS CLI使用

如需通过AWS CLI操作AWS服务，需挂载本地AWS凭证文件（通常位于~/.aws）到容器内用户1001的家目录：

shell
docker run --rm \
  -v $(pwd):/e2e \
  -v ~/.aws:/home/1001/.aws \  # 挂载AWS凭证（包含credentials和config文件）
  cypress/included:13.13.1 --user 1001 \
  sh -c "aws s3 ls && cypress run"  # 先列出S3存储桶，再执行Cypress测试

自定义配置

修改运行用户

如需以其他用户身份运行，可通过--user参数覆盖默认用户1001：

shell
docker run --rm -v $(pwd):/e2e --user root cypress/included:13.13.1  # 以root用户运行（不推荐，仅用于调试）

配置AWS CLI环境变量

若未挂载本地AWS凭证文件，可通过环境变量传递AWS访问密钥：

shell
docker run --rm \
  -v $(pwd):/e2e \
  -e AWS_ACCESS_KEY_ID=your_access_key \
  -e AWS_SECRET_ACCESS_KEY=your_secret_key \
  -e AWS_REGION=us-east-1 \
  cypress/included:13.13.1 --user 1001 \
  aws s3 cp /e2e/test-result.png s3://your-bucket/  # 上传测试结果到S3

使用curl工具

在测试脚本或容器命令中直接调用curl：

shell
# 在容器内执行curl获取外部数据，再运行测试
docker run --rm -v $(pwd):/e2e cypress/included:13.13.1 --user 1001 \
  sh -c "curl https://api.example.com/test-data > /e2e/fixtures/data.json && cypress run"

注意事项

1. 文件权限：由于默认用户为1001，挂载的本地目录需确保用户1001有读写权限（可通过chmod 777临时开放权限，或在宿主机创建UID为1001的用户）。
2. AWS凭证安全：避免在命令行直接暴露AWS密钥，优先通过挂载~/.aws目录或使用CI/CD环境变量管理凭证。
3. Cypress版本兼容性：本镜像基于cypress/included:13.13.1，请确保测试代码兼容Cypress 13.13.1版本。