Skip to content

test: use Docker image cypress/browsers in parallel record example - #1886

Open
MikeMcC399 wants to merge 1 commit into
cypress-io:masterfrom
MikeMcC399:record-with-docker
Open

test: use Docker image cypress/browsers in parallel record example#1886
MikeMcC399 wants to merge 1 commit into
cypress-io:masterfrom
MikeMcC399:record-with-docker

Conversation

@MikeMcC399

@MikeMcC399 MikeMcC399 commented Sep 4, 2026

Copy link
Copy Markdown
Collaborator

Situation

Cypress 16.0.0 deprecates the built-in Electron browser.

As described in #1727 and in the README documentation Parallel section, parallel recording into Cypress Cloud using browsers provided by GitHub Actions runners can cause version mismatch errors during runner deployments that may span several days.

The advice has been to use a Cypress Docker image to ensure consistent versions across parallel runs.

Note that this is only applicable to Ubuntu runner images. Docker containers cannot run under macOS or Windows on GitHub Actions.

Change

Update Cypress Cloud recording examples to use the cypress/browsers Docker image.

Rename the strategy: matrix parameter from container to recording-job to avoid confusion with the Docker container.


Note

Low Risk
Documentation and example CI workflow only; no changes to the action runtime or user-facing behavior beyond recommended patterns.

Overview
Updates parallel Cypress Cloud recording guidance and the example-recording workflow so matrix jobs run inside cypress/browsers (pinned 24.20.0 in the live example, latest in the README snippet) with --user 1001, keeping browser versions aligned across parallel runners during GitHub-hosted image rollouts.

Renames the matrix axis from containers to recording-job to distinguish GitHub Actions matrix copies from the job’s Docker container block. The Parallel README section is reworded around “jobs” instead of “containers,” expands Ubuntu Docker guidance, and discourages parallel recording on macOS/Windows where the mismatch workaround does not apply; adds a link to the recording example workflow badge.

Reviewed by Cursor Bugbot for commit 8d5acbc. Bugbot is set up for automated code reviews on this repo. Configure here.

@cypress-app-bot

Copy link
Copy Markdown
Collaborator

@MikeMcC399

Copy link
Copy Markdown
Collaborator Author

@MikeMcC399
MikeMcC399 marked this pull request as ready for review September 4, 2026 14:09
@MikeMcC399 MikeMcC399 self-assigned this Sep 4, 2026
@MikeMcC399 MikeMcC399 added type: enhancement New feature or request Cypress Cloud labels Sep 4, 2026
@MikeMcC399 MikeMcC399 changed the title test: use Docker image cypress/browser in parallel record example test: use Docker image cypress/browsers in parallel record example Sep 4, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Prepare for Electron deprecation in Cypress Cloud parallel recording

2 participants