Production-ready CI/CD configurations for Playwright — GitHub Actions, GitLab CI, CircleCI, Azure DevOps, Jenkins, Docker, parallel sharding, reporting, code coverage, and global setup/teardown.
name: playwright-ci
description: Production-ready CI/CD configurations for Playwright — GitHub Actions, GitLab CI, CircleCI, Azure DevOps, Jenkins, Docker, parallel sharding, reporting, code coverage, and global setup/teardown.
Playwright CI/CD
Ship reliable tests in every pipeline — CI-specific patterns for speed, stability, and actionable reports.
9 guides covering CI/CD setup, parallel execution, containerized runs, reporting, and infrastructure patterns for all major CI providers.
Golden Rules
retries: 2 in CI only — surface flakiness in pipelines, not locally
traces: 'on-first-retry' — capture rich debugging artifacts without slowing every run
- Shard across runners —
--shard=N/M splits tests evenly; scale horizontally, not vertically
- Cache browser binaries —
~/.cache/ms-playwright keyed on Playwright version
- Upload artifacts on failure — traces, screenshots, and HTML reports as CI artifacts
- Use the official Docker image —
mcr.microsoft.com/playwright:v* has all OS deps pre-installed
- Global setup for auth — run login once in
globalSetup, reuse storageState across workers
- Fail fast, debug later — keep CI runs short; use trace viewer and HTML reports to investigate
Guide Index
CI Providers
Execution & Scaling
Reporting & Setup