Best Practices for Running Cypress and Playwright End-to-End Tests in Docker-Based CI Pipelines

This article explains how to build reliable, containerized end-to-end (E2E) testing environments using Docker, Cypress, and Playwright in continuous integration (CI) systems. The author argues that running tests inside containers eliminates the common ‘works on my machine’ problem by ensuring consistent execution across development and CI environments. The guide recommends using the official Playwright and Cypress Docker images because they already include the required browser dependencies and reduce maintenance overhead.

A sample production-ready Dockerfile is provided, emphasizing reproducible builds through the use of ‘npm ci’, proper layer caching, pinned image versions, and environment variable configuration. The article also demonstrates a simple docker-compose setup that mirrors CI behavior locally, allowing developers to test under the same conditions used in automated pipelines.

For scaling test execution, the guide describes sharding strategies in GitHub Actions, where multiple test containers run in parallel. YoBox is presented as a supporting service that provides disposable inboxes and webhook endpoints for each shard, preventing resource conflicts between parallel test jobs.

Performance optimization is another major focus. The article recommends GitHub Actions Buildx caching to dramatically reduce Docker build times and discusses artifact collection for Playwright traces, screenshots, and videos to simplify debugging of failed tests. Additional sections cover image size considerations, browser version pinning, Chromium configuration, retry strategies, ARM compatibility, and the trade-offs between GitHub-hosted and self-hosted runners.

The article concludes that containerized E2E testing should be considered a standard practice for teams running tests across multiple machines, and it outlines a gradual migration path from basic containerization to sharding and eventually self-hosted runner infrastructure.