Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Executing the tests using Cloud Runner

Execute the generated tests suite using the Cloud Runner browser option.

Before you begin

Note: ATF test data will temporarily be in the browser session which are stored in our ServiceNow data center. Test data will be removed after all test executions have been completed.

Role required: admin

Procedure

  1. Navigate to All > Automated Test Framework (ATF) > Suites > ATF Generated Suite.

    Note: You can also execute an individual test. Navigate to All > Automated Test Framework (ATF) > Tests.

  2. Select Run Test Suite to execute the selected suite.

    Note: You can also execute an individual test using the cloud runner browser option.

    The Pick a Browser dialog box shows up.

  3. Select one of the two available options to run the test suite.

Image omitted: atf-tg-cr-execute-tests.png
Image showing the test execution with Cloud Runner option
-   Start a new test runner: Runs the test by starting a new tab
-   Cloud Runner: Runs the test in the cloud

    **Note:** As an admin user, you can hide the Cloud Runner option on the Pick a browser dialog box by setting the atf\_cloud\_runner.radio\_visible to false. The property is set to true by default.

**Note:** If you run a test suite using the cloud runner, all the tests within the suite run in parallel. See [Parallel testing using Cloud Runner](atf-tg-cr-parallel-test.md) for more information. The order in which the tests in a suite run is random. The parallel suites ignore the execution order and ignore abort on failure.
  1. Select Run Test Suite on the dialog box after selecting the browser.

    Note: The number of cloud runners that can be used simultaneously is two by default. You also have the option of buying five more cloud runners.

    The execution of the tests continues at the background even if you close the progress bar.

  2. Select Go to Result if you want to review the tests execution results.

  3. Parallel testing using Cloud Runner
    Parallel testing using the Cloud Runner involves execution of tests within a suite in parallel.

Parent Topic:Using ATF Test Generator and Cloud Runner

Related topics

Scheduling test execution