Get Started

Get started with a free parallelization using sorry-cypress

Let's start by running basic sorry-cypress configuration:

docker run agoldis/sorry-cypress-director

We've just launched director service on http://localhost:1234 - this service coordinates cypress agents and enables free parallelization.

Re-configuring cypress agent

We need to override cypress agents configuration to start using the local director service:

# Let's find cypress runner location
DEBUG=cypress:* cypress version
# Examine the output, note the path
"cypress:cli Reading binary package.json from: /Users/agoldis/Library/Caches/Cypress/6.2.1/ +0ms"
# Now let's override cypress agent configuration
vim /Users/agoldis/Library/Caches/Cypress/6.2.1/
# api_url: ""
api_url: "http://localhost:1234/"

Running cypress tests in parallel

Let's open several terminal windows and run cypress in each. Make sure you have cypress tests defined in advance (clone if you don't have any test handy).

# run in each terminal
cypress run --parallel --record --key somekey --ci-build-id hello-cypress

You'll notice that different instances of cypress agent are running different tests.

🎉 We've just finished the basic setup of sorry-cypress and ran our tests in parallel!

  • Use the same --ci-build-id to associate different cypress agents with the same run

  • You can run as many cypress agents as you want - each will run a different test suite

  • This basic director configuration keeps all the test results in-memory. Restarting it wipes all the data