test: use Docker image cypress/browsers in parallel record examples

[MikeMcC399]

• closes Prepare for Electron deprecation in Cypress Cloud parallel recording #1772

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.

• README > Parallel
• .github/workflows/example-custom-ci-build-id.yml
• .github/workflows/example-recording.yml

---

Note

Low Risk
Documentation and example workflow YAML only; no changes to the action runtime or user-facing API behavior.

Overview
Updates parallel Cypress Cloud recording guidance and live examples to run matrix jobs inside cypress/browsers Docker (options: --user 1001) so parallel runs share consistent browser versions during GitHub-hosted Ubuntu runner rollouts.

Renames the matrix dimension from containers to recording-job to distinguish GitHub Actions job copies from the job’s Docker container. README Parallel, Custom build id, and Robust custom build id snippets match the workflow changes and add clearer notes to prefer Docker on Ubuntu parallel recording and to avoid parallel recording on macOS/Windows.

^{Reviewed by Cursor Bugbot for commit fda4421. Bugbot is set up for automated code reviews on this repo. Configure here.}

[cypress-app-bot]

• Create a Draft Pull Request if your PR is not ready for review. Mark the PR as Ready for Review when you're ready for a Cypress team member to review the PR.

[MikeMcC399]

Preview

• https://github.com/MikeMcC399/github-action/tree/record-with-docker#parallel

[MikeMcC399]

• Cypress Cloud parallel recording workflows are now failing due to Parallel record fails on GitHub Actions with Ubuntu patch version update 24.04.n / 24.04.n+1 cypress#33536

• This PR works around the issue by isolating the Cypress Cloud parallel recording runs through using a cypress/browsers Docker image, which provides a consistent testing environment across parallel jobs