关于 playwright-ci
Playwright CI/CD 为在持续集成流水线中运行 Playwright 测试的团队提供指南，涵盖 CI 提供商配置、规模化执行、容器、报告和基础设施实践。
主要功能
- 01CI 提供商配置指南
- 02并行执行与分片
- 03Docker 和容器指南
- 04报告与构建产物处理
- 05覆盖率及全局设置指南
适用场景
- 01在 CI 流水线中配置 Playwright
- 02将测试分配到多个 CI 运行器
- 03失败后收集跟踪记录和报告
- 04在多个工作进程间复用认证状态
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/playwright-ci确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
ci-github-actions.mdci-gitlab.mdci-other.mddocker-and-containers.mdglobal-setup-teardown.mdparallel-and-sharding.mdprojects-and-dependencies.mdreporting-and-artifacts.mdtest-coverage.md详细介绍
Playwright CI/CD
在每条流水线中交付可靠的测试——适用于 CI 的模式，助你提升速度、稳定性并生成可执行的报告。
9 篇指南涵盖 CI/CD 设置、并行执行、容器化运行、报告和基础设施模式，适用于所有主流 CI 提供商。
黄金法则
- 仅在 CI 中设置
retries: 2——在流水线中暴露不稳定问题，而非本地运行时 - 设置
traces: 'on-first-retry'——捕获丰富的调试产物，同时避免拖慢每次运行 - 在多个运行器之间分片——
--shard=N/M可均匀拆分测试；横向扩展，而非纵向扩展 - 缓存浏览器二进制文件——按 Playwright 版本为
~/.cache/ms-playwright建立缓存键 - 失败时上传产物——将追踪、屏幕截图和 HTML 报告作为 CI 产物上传
- 使用官方 Docker 镜像——
mcr.microsoft.com/playwright:v*已预装所有操作系统依赖项 - 使用全局设置完成身份验证——在
globalSetup中登录一次，并在各工作进程之间复用storageState - 快速失败，之后再调试——缩短 CI 运行时间；使用追踪查看器和 HTML 报告进行排查
指南索引
CI 提供商
| 提供商 | 指南 |
|---|---|
| GitHub Actions | ci-github-actions.md |
| GitLab CI | ci-gitlab.md |
| CircleCI / Azure DevOps / Jenkins | ci-other.md |
执行与扩展
| 主题 | 指南 |
|---|---|
| 并行执行与分片 | parallel-and-sharding.md |
| Docker 与容器 | docker-and-containers.md |
| 多项目配置 | projects-and-dependencies.md |
报告与设置
| 主题 | 指南 |
|---|---|
| 报告与产物 | reporting-and-artifacts.md |
| 代码覆盖率 | test-coverage.md |
| 全局设置/清理 | global-setup-teardown.md |
评论
支持 Markdown