davidsiv/sem-playwright

Playwright CI测试镜像

镜像概述

本Docker镜像专为CI/CD环境设计，用于简化Playwright自动化测试在持续集成流程中的部署与执行。镜像预安装Playwright及其完整依赖（包括浏览器二进制文件、系统库等），无需额外配置即可直接运行Playwright测试脚本，有效降低CI环境中测试环境搭建的复杂度。

核心功能与特性

预配置环境

• 内置最新稳定版Playwright及Node.js运行时
• 预安装Chrome、Firefox、WebKit等主流浏览器二进制文件
• 包含Playwright测试所需的系统依赖库（如字体、音频视频支持库等）

多浏览器支持

• 原生支持Chromium、Firefox、WebKit三大浏览器引擎
• 支持无头模式运行，适配CI环境无图形界面场景
• 内置浏览器版本与Playwright版本严格匹配，避免兼容性问题

CI环境优化

• 精简镜像体积，优化CI环境拉取速度
• 支持非root用户运行，符合容器安全最佳实践
• 兼容主流CI平台（GitHub Actions、GitLab CI、Jenkins、CircleCI等）

使用场景

• CI/CD流水线中的自动化测试环节
• 多浏览器兼容性测试验证
• 前端应用的E2E（端到端）测试自动化
• 测试脚本的快速验证与调试（本地模拟CI环境）

使用方法

基本运行命令

bash
docker run --rm -v $(pwd):/tests docker.xuanyuan.run/playwright-ci-image npx playwright test

参数说明

• -v $(pwd):/tests: 将本地测试文件目录挂载到容器内/tests目录（默认工作目录）
• npx playwright test: 执行Playwright测试命令（可根据实际测试脚本调整）

自定义测试命令

若测试脚本位于非默认路径或需要指定测试文件：

bash
docker run --rm -v $(pwd)/e2e:/tests docker.xuanyuan.run/playwright-ci-image npx playwright test ./specs/login.spec.ts

多浏览器测试

指定浏览器运行测试（默认运行所有已安装浏览器）：

bash
docker run --rm -v $(pwd):/tests docker.xuanyuan.run/playwright-ci-image npx playwright test --project=chromium
docker run --rm -v $(pwd):/tests docker.xuanyuan.run/playwright-ci-image npx playwright test --project=firefox
docker run --rm -v $(pwd):/tests docker.xuanyuan.run/playwright-ci-image npx playwright test --project=webkit

环境变量配置

docker-compose示例

yaml
version: '3.8'
services:
  playwright-test:
    image: docker.xuanyuan.run/playwright-ci-image
    volumes:
      - ./tests:/tests
      - ./reports:/tests/reports  # 挂载报告目录，持久化测试结果
    environment:
      - NODE_ENV=ci
      - TEST_REPORT_DIR=/tests/reports
    command: npx playwright test --reporter=html

注意事项

• 测试文件需通过卷挂载至容器内（推荐挂载至/tests目录）
• 如需自定义浏览器版本，可通过PLAYWRIGHT_BROWSERS_PATH指定外部浏览器路径
• 运行时建议添加--rm参数清理临时容器，减少CI环境存储占用