Try TestCloud: A new cloud-based testing environment from Katalon

1. Why should I use TestCloud?

Katalon TestCloud is a cloud-based testing environment that allows you to securely and flexibly execute your end-to-end test flow.

Two reasons why TestCloud would be a wise choice:

  • Native integration: If you are currently using any products of the Katalon platform, you can easily connect to TesCloud in just a few clicks.
  • Inclusive support: Because TestCloud is a part of the Katalon platform, you can get timely support from Katalon when having technical issues.

<> Get your concerns tackled:

2. I am using Katalon Studio, how can I integrate it with TestCloud?

You can follow these steps:

  • Step 1: Open Katalon Studio.
  • Step 2: Go to Project > Settings > Katalon TestCloud.

<> Notes:
You can also click on the TestCloud icon in the top right corner of KS to open the settings.
tc icon in ks
The Project Settings dialog appears as below.
tc icon in ks

  • Step 3: Ensure that the Enable Katalon TestCloud integration box is checked.
  • Step 4: Choose the organization you wish to run your test with.

<> Notes:
If you cannot find your desired organization, click Fetch Organization to refresh. It will retrieve the list of all available organizations you have joined.

  • Step 5: Click Apply and Close.

Once you have enabled TestCloud integration, you have the option to run a test suite/test suite collection (TS/TSC) with TestCloud.

3. I am using Katalon Runtime Engine. How to run test suites/test suite collections with TestCloud?

To integrate KRE with TestCloud and configure TestCloud Tunnel, use the following Katalon command-line options:

<> Notes: To get the TestCloud environment ID, open Katalon Studio and use the command builder.

Generate Command with Command Builder

You can use Command Builder in Katalon Studio (KS) to generate commands quickly and precisely.

<> Requirements: You have enabled TestCloud integration in KS (following the steps in the above section)

Follow these steps:

Step 1: Open KS and click on the Build CMD button in the main toolbar.
Build CMD
The Generate Command for Console Mode appears as below.
generate cmd dialog

Step 2: Configure your execution as follows:

  • Test Suite: select the TS/TSC you want to execute.
  • Executive Platform:
    • Run with: Click Edit to display the Select an environment dialog, select TestCloud, then click OK.
      run config tsc
      The Run Configuration option will appear after you choose TestCloud as your test environment.
    • Run Configuration: Click Edit to display the TestCloud Configuration (Beta) dialog, select your desired remote OS, browser, and browser version.
      tc config dialog

<> Notes: To run tests using the TestCloud tunnel, check the Execute with Tunnel box for the private domain testing box and refer to Configure TestCloud Tunnel for detailed instructions.

  • Authentication: the API key is auto-filled.

<> Notes: For detailed information on the command builder, see Command Builder.

Step 3: Click Generate Command.
The Generated Command dialog appears as below.
generate cmd dialog

<> Notes: After configuring your desired remote OS, browser, and browser version, TestCloud generates a TestCloud environment ID accordingly. You can get this ID in the Generated Command dialog (e.g. -testcloudEnvironmentId=“38”).
For example, the sample command is:
./katalonc -noSplash -runMode=console -projectPath=“your_project_path” -retry=0 -testSuitePath=“your_test_suite_path” -browserType=“TestCloud” -testcloudEnvironmentId=“your_testcloud_id” -testcloudTunnel=“false” -executionProfile=“default” -apiKey=“your_api_key” -orgID=your_ogrID --config -proxy.auth.option=NO_PROXY -proxy.system.option=NO_PROXY -proxy.system.applyToDesiredCapabilities=true

Step 4: Click Copy to Clipboard and paste the command to your cmd/terminal for execution.

4. I am using TestOps, how can I run tests with TestCloud?

Run tests in public domains with TestCloud

Step 1: Sign in to Katalon TestOps and go to your Project.

Step 2: Go to Test Planning and click Schedule Test Run.
The Schedule Test Run dialog pops up.

Step 3: Select TestCloud Test Environment from the dropdown list in the Test Environment Type section.
The TestCloud section will appear as below.
testcloud section in schedule test run dialog

Step 4: Select the OS and browsers you want to test in the TestCloud section.

Step 5: Click Schedule.
You are directed to the Test Run List page, where you can see the TestCloud Test Environment.

Step 6: Click on the Play icon to run tests.

These are the steps to run tests in public domains using the TestCloud Test Environment.

Run tests in private domains with TestCloud

Step 1: Sign in to Katalon TestOps and go to your Project.

Step 2: Go to Test Planning > Schedule Test Run.
The Schedule Test Run dialog pops up.

Step 3: Select TestCloud Test Environment from the dropdown list in the Test Environment Type section.

Step 4: Switch the toggle Use TestCloud Tunnel on.
test run types page run with testcloud successfully

Step 5: Select the OS and browsers in the TestCloud section.

Step 6: Click Schedule.
You are directed to the Test Run List page, where you can see the newly-added TestCloud Test Environment.

Step 7: Follow the below guidelines to configure the TestCloud Tunnel.

Configure TestCloud Tunnel

<> Requirements:

  • To allow User Datagram Protocol (UDP) connections, the proxy must be configured.

  • If you use a Man-in-the-Middle (MITM) proxy, it must be configured to allow Transport Layer Security (TLS) connections.

For detailed information on TestCloud Tunnel and how to utilize it, see TestCloud Tunnel.

After scheduling your test runs using TestCloud Tunnel, you need to activate this tunnel to start test executions in private domains.

Follow these steps:

  1. Go to Configurations > TestCloud Tunnels.
    The TestCloud Tunnels page appears.

  2. Select the Setup tab.
    testcloud tunnel page
    You will see an on-screen step-by-step instruction to set up your TestCloud tunnel.
    Follow the on-screen instructions:
    i. Select your OS, download the binary file, and unzip the file.
    ii. Right-click on the file to open it in the terminal (for macOS), or open the file in cmd.exe (for Windows).
    iii. Copy the command in the Generate configuration section, paste it in Terminal/cmd, then hit Enter to run the command.
    configure testcloud tunnel
    iv. Copy the command in the Start a tunnel section, paste it in Terminal/cmd, then click Enter to run the command.
    configure testcloud tunnel
    You have successfully configured the TestCloud Tunnel.

  3. Go to the TestCloud Tunnels page and select the Tunnels tab.
    configure testcloud tunnel
    You can now see the Active status in the TestCloud Tunnel you have activated.

  4. Go to the Test Run List page and click on the Play icon to run your tests.

You have successfully run your tests in private domains using the TestCloud Test Environment.

2 Likes