Integrate TestCloud with Katalon Runtime Engine

Katalon TestCloud is a cloud-based test execution environment where you can automate test scripts across the most common and updated browsers and/or operating systems (OS) and/or a combination of both. See: TestCloud Overview.

From version 8.2.5 onwards, you can run test suites/test suite collections (TS/TSC) with TestCloud in Katalon Runtime Engine (KRE).

You can also configure TestCloud Tunnel to run tests in private domains. For detailed information on TestCloud Tunnel and how to utilize it, see TestCloud Tunnel.

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

Requirements

• An active Katalon TestCloud subscription or trial. See TestCloud Trial.

• An active Katalon Runtime Engine license.
• Katalon Runtime Engine version 8.2.5 onwards.

Run test suites/test suite collections with TestCloud in Katalon Runtime Engine

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

No.	Katalonc Command-line Option	Description	Data type	Mandatory
1	-testcloudEnvironmentId	The ID of the environment which corresponds to a combination of OS, browser type and browser version to execute. Note: This parameter already contains the information about the browser type. Therefore, the browserType parameter is not generated in this integration.	Text	Required
2	-testcloudTunnel	Allow the execution to be performed via a tunnel.	Boolean (case-insensitive)	Optional

Note:

• To get the TestCloud environment ID, open Katalon Studio and use the command builder. See: Generate Command with Command Builder.

Generate Command with Command Builder

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

Important:

• You have enabled TestCloud integration in KS. See: Integrate TestCloud with Studio

Follow these steps:

1. Open KS and click on the Build CMD button in the main toolbar.

   
   
   

   The Generate Command for Console Mode appears as below.

   
   
   

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.

       
       
       

       The Run Configuration option appears 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.

       
       
       

       Note:

       • To run tests using the TestCloud tunnel, check the Execute with Tunnel for private domain testing box and refer to Configure TestCloud Tunnel for detailed instruction.

   • Authentication: the API key is auto-filled.

   Note:

   • For detailed information on the command builder, see Command Builder.

3. Click Generate Command.

   The Generated Command dialog appears as below.

   
   
   

   Note:

   • 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

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