How to deploy and schedule your Cypress tests in the cloud

If you're already using Apify and have Cypress code that needs a home, you're in luck. We created Cypress Test Runner to make running Cypress tests in the Apify cloud a breeze.

Content

If you're already using Apify and have Cypress code that needs a home, you're in luck. We created Cypress Test Runner to make running Cypress tests on the Apify web scraping platform a breeze. Let's see how you can use it.

☁️ Cloud alternatives for testing

When it comes to running your Cypress tests in the cloud, there are a few options available:

  1. Cypress Cloud and its alternatives. Cypress Cloud provides a hosted solution for running your Cypress tests, allowing you to execute your tests on a remote infrastructure efficiently. There are also open-source alternatives for running Cypress tests and collecting test results.
  2. Run it in CI/CD pipelines. Integrating your Cypress tests into your CI/CD pipelines is another practical approach – tested and used by us here at Apify daily. By plugging your tests into your existing processes, such as to GitHub Actions, you can seamlessly incorporate testing into your development workflow.
Example of our CI/CD pipeline we have on GitHub
Example of our CI/CD pipeline we have on GitHub

🥾Guide on how to deploy and schedule Cypress tests in the cloud

If you want to set regular runs for your Cypress tests in the Apify cloud, follow these steps:

Step 1. Choose Cypress Test Runner

Cypress Test Runner Actor card in Apify Store
Step 1. Choose Cypress Test Runner

Head over to Apify Store and search for Cypress. You'll find the Cypress Test Runner 🔗. Click Try for free and sign in using your email to get started.

Step 2. Record or write your tests

An example of exporting a test made through Cypress Test Recorder
How to record a Cypress test using Cypress Recorder

Of course, you can add manually written tests as well. But by using the Cypress Test Recorder extension, you can make your test writing faster. Check out our guide 🔗 on how to record your tests using the Cypress Recorder Extension in Chrome.

How to record Cypress tests with Cypress Recorder
Is Cypress Recorder the tool to automate writing manual tests?

How to record a Cypress test using Cypress Recorder

Step 3. Export and paste your tests

Step 3. Export and paste your tests

After recording your tests, export them from the Recorder and paste the test code into Cypress Test Runner. This step allows you to set up the runner with your specific tests for execution.

Step 4. Start the run

Run result: one test failed and one test succeeded
Run result: one test failed and one test succeeded

Now click on Start and wait for the run to complete the test. Once your tests are done running, you'll see the Status of the run change to ✅ Succeeded or ❌ Failed. If any of your Cypress tests fail, the whole run will be marked as Failed.

You can also check the full log of every test run.

Step 5. Check the dashboard

To see the test results, copy the dashboard link on the Run panel. The dashboard will provide valuable insights into your test runs, including detailed test results, metrics, and visual aids. You can use this information to analyze the performance and identify any issues or areas for improving your tests.

Step 6. Save your run as a task

Step 6. Save your run as a task
Step 6. Save your run as a task

If you want to schedule your test to run regularly, you'll have to create a Task. To create a Task, simply head for the Input of your Run and click Save input to a new task.

Now name your task, tweak the Input if needed, and click Schedule.

Step 7. Schedule your test to run hourly, daily, etc.

One last thing to do: choose how often you want the Cypress test to run (weekly, monthly, daily, hourly, custom time, or by cron expression). Don't forget to pick your time zone so the run happens exactly when you need it to.

Step 7. Schedule your test to run hourly, daily, etc.
Step 7. Schedule your test to run hourly, daily, etc.

Following these steps with Cypress Test Runner, you can effortlessly deploy and schedule your Cypress tests in the Apify cloud. Enjoy the benefits of running your tests remotely, gaining valuable insights, and improving the quality of your software.

📇 Template for Cypress Actors

If you prefer to build your Cypress Actor, we have a template available to help you get started. This template is the foundation for any container with Cypress tests (including the one this tutorial is about). It helps our users to create their own Cypress testing solutions faster. Try it and see if it helps you, too!

Template for creating Cypress Actors
Josef Válek
Josef Válek
Full-stack developer @apify.
Natasha Lekh
Natasha Lekh
Crafting content that charms both readers and Google’s algorithms: readmes, blogs, and SEO secrets.

Get started now

Step up your web scraping and automation