Integrate TestCloud with Studio

Katalon TestCloud is a test automation service that allows you to execute tests on common browsers and operating systems on the cloud. With Katalon TestCloud, you can easily configure those test environments.

To learn more about how TestCloud can enhance your test automation projects, refer to this document: TestCloud Overview.

This guide shows you how to configure TestCloud integration (Beta) in Katalon Studio (KS) and execute tests/view reports with TestCloud.

Important:

• Katalon Studio version 8.2.5 onwards.

Integrate TestCloud with Studio

Note:

• To use your proxy for TestCloud integration, you should configure both Authentication Proxy and System Proxy in Preferences. Learn more about proxy configurations at Proxy Preferences.

To integrate TestCloud with Katalon Studio, follow these steps:

1. Open Katalon Studio.

2. Open the settings for TestCloud integration. Click on the TestCloud icon in the top right corner.
   
   

   Note:

   • You can also access the settings by navigating to Project > Settings > Katalon TestCloud.
     
     

   The Project Settings dialog appears as below.

   
   
   

3. Ensure that the Enable Katalon TestCloud integration box is checked.

4. Choose the organization you wish to run your tests with.

   Note:

   • If you cannot find your desired organization, click Fetch Organization to refresh. This action retrieves the list of all available organizations you have joined. You can select the organization you want from the dropdown menu.

5. Click Apply and Close.

   You have now enabled TestCloud integration in Katalon Studio and have the option to run a test suite or a test suite collection with TestCloud.

Run test suites with TestCloud

Note:

• You cannot run test cases with TestCloud.

To run TS with TestCloud, follow these steps:

1. Open your TS.

2. Click on the dropdown icon of the Run button and choose to run with TestCloud.

   
   
   

   The TestCloud Configuration (Beta) dialog appears as below.

   
   
   

3. Select the OS, browser, and browser version in the Configuration section.

   Note:

   • We currently only support Linux and Windows (remote OS). For browsers, we support Chrome, Edge Chromium, and Firefox.
   • The Tunnel checkbox is cleared by default. TestCloud Tunnel is for running tests in private domains. See: Configure TestCloud Tunnel.

4. Click Run.

Run test suite collections with TestCloud

To run TSC with TestCloud, follow these steps:

1. Open your TSC and double-click the Run with column.

   
   
   

   The Select an environment dialog appears as below.

   
   
   

2. Choose TestCloud as your test environment, then click OK.

3. Double click on the Run Configuration column to open the TestCloud Configuration dialog.

   The TestCloud Configuration (Beta) dialog appears as below.

   
   
   

4. Select the OS, browser, and browser version in the Configuration section.

   Note:

   • We currently only support Linux (remote OS). For browsers, we support Chrome and Firefox.
   • The Tunnel checkbox is cleared by default. TestCloud Tunnel is for running tests in private domains. See: Configure TestCloud Tunnel.

5. Click OK.

Configure TestCloud Tunnel

If you want to execute test suites or test suite collections in private domains with TestCloud, you must use TestCloud Tunnel.

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

Important:

• 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.

TestCloud Tunnel can be configured with Tunnel Setup Helper.

Follow these steps:

1. Open the TestCloud Configuration (Beta) dialog.

2. Select the Execute with Tunnel for private domain testing checkbox.

   You will see a message in red, as follows:

   

3. Click on the Tunnel Setup Helper link in the message.

   The Tunnel Setup Helper dialog appears as below.

   

4. Follow the step-by-step instructions in the dialog to set up the tunnel client in your local machine:

   • Step 1: Select your OS and download the .zip file, then unzip it.

   • Step 2: Open the command-line interface (CLI) and navigate to the directory containing the TC-tunnel executable file. Copy the command line from the dialog, then run it in the CLI.

     An example command looks like this:

     /Applications/kt config --tenant KatalonStudio --username "your_username" --organization-id "your_organization_id" --api-key "your_api_key"

     You have set up the tunnel client in your local machine.

   • Step 3: Copy the command in the dialog and run it in your CLI to start the tunnel.

     A sample command looks like this:

     /Applications/kt start

     

   Note:

   • Keep your CLI (cmd/terminal) open until you have finished running tests.

5. Go back to the Tunnel Setup Helper dialog and click Close.

   Once you have started the tunnel in your local machine, the TestCloud Configuration (Beta) dialog displays a green Status: Available message.

   

   Note:

   • You can also click on the Refresh button to have the status updated.

6. Click Run to start executing your test suite/test suite collection with TestCloud Tunnel.

View TestCloud reports

After executing tests with TestCloud from Katalon Studio, execution data is consolidated in logs and reports. You can view TestCloud reports in the following formats: CSV, PDF, JUnit, HTML.

See: Test Suite and Test Suite Collection Reports.