playwright-ci

Playwright CI/CD 旨在帮助团队在每条流水线中运行可靠的 Playwright 测试，提供针对 CI 场景的速度、稳定性与报告模式。该技能共包含 9 篇指南，覆盖 CI/CD 配置、并行执行、容器化运行、报告以及面向各主流 CI 服务商的基础设施模式。

核心原则（Golden Rules）

资料中明确列出以下原则：

• 仅在 CI 中设置 retries: 2 —— 让不稳定性暴露在流水线中，而不是本地。
• traces: 'on-first-retry' —— 在不拖慢每次运行的前提下捕获丰富的调试产物。
• 跨 runner 分片 —— 使用 --shard=N/M 平均拆分测试；水平扩展而非垂直扩展。
• 缓存浏览器二进制 —— 以 Playwright 版本为键缓存 ~/.cache/ms-playwright。
• 失败时上传制品 —— 将 trace、截图和 HTML 报告作为 CI 制品上传。
• 使用官方 Docker 镜像 —— mcr.microsoft.com/playwright:v* 已预装全部操作系统依赖。
• 用全局 setup 处理认证 —— 在 globalSetup 中登录一次，并在各 worker 间复用 storageState。
• 快速失败、稍后调试 —— 保持 CI 运行简短；使用 trace viewer 与 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
• 全局 setup/teardown：global-setup-teardown.md

适用场景与限制

该技能适用于需要在 CI/CD 流水线中配置和运行 Playwright 测试的工程团队，尤其是希望优化并行执行、容器化运行、报告与制品管理以及代码覆盖率的场景。关于具体价格、收费方式、平台支持细节或实际使用步骤，资料中暂未提供。