Set up the Tosca Cloud execution integration

We offer different integration options between Tosca on-premises and Tosca Cloud. With the test execution integration option, you keep your tests on-premises but run them in Tosca Cloud. To run the tests, you use the cloud's test execution service, Elastic Execution Grid.

This topic explains how to prepare Tosca on-premises so you can trigger cloud test runs.

The test execution integration between Tosca on-premises and Tosca Cloud is in public beta and still under development. We don't guarantee full functionality in this or in future versions.

Tosca Cloud—and Elastic Execution Grid—themselves have fully transitioned to general availability.

Before you start

Before you can start your setup, you need to have these things: 

Set up Tosca on-premises for integration

Tosca on-premises uses the Automation Object Service (AOS) to forward tests to Tosca Cloud and get back results. AOS is a component of Tosca Distributed Execution.

Keep these things in mind:

  • If you already have Tosca Distributed Execution with AOS installed, you still need to perform a few steps to set up the integration.

  • If you use legacy Tosca Distributed Execution, you need to configure AOS for integration with Tosca Cloud. However, this integration doesn't affect your on-premises tests at all. You can still use legacy Tosca Distributed Execution for on-premises test runs after you set up the integration.

  • If you don't use Tosca Distributed Execution and don't plan to use it, don't worry. You only need to configure AOS for integration. You don't need a full Tosca Distributed Execution installation to enable integration with Tosca Cloud.

On-premises setup workflow

Your next steps depend on what you already use. Please choose your use case:

To set up the test execution integration with Tosca Cloud, follow these steps:

  1. In Tosca Cloud, go to User menu-> Settings-> Integrations, find the Elastic Execution Grid integration, and select Set up integration. Here, you'll find the client secret (opens in new tab) and other information you'll need for future setup steps.

  2. Configure AOS for the integration: 

  3. Open a workspace in Tosca Commander.

  4. Configure the connection between Tosca client and Tosca Gateway Service. Go to Project->Settings->Tricentis Services and fill out the setting ServerEndpointAddress.

    You need to do this on all machines where you want to create tests and trigger test runs. Alternatively, create project settings to apply the setting to all workspaces connected to the repository.

  5. Create the necessary infrastructure for cloud test artifacts:

    • Check out the project root element. This is an important step! It ensures that Tosca adds all necessary property definitions.

    • In the Execution tab, right-click the Execution folder and select Create ElasticExecutionGridEvents folder from the mini toolbar. You only need to do this once.

And that's it!

To set up the test execution integration with Tosca Cloud, follow these steps:

  1. In Tosca Cloud, go to User menu-> Settings-> Integrations, find the Elastic Execution Grid integration, and select Set up integration. Here, you'll find the client secret (opens in new tab) and other information you'll need for future setup steps.

  2. In Tosca on-premises, create an AOS workspace. An AOS workspace is a "background" workspace that gives AOS access to all necessary test artifacts in the repository.

  3. Configure AOS for the integration: 

  4. Open a workspace in Tosca Commander.

  5. Configure the connection between Tosca client and Tosca Gateway Service. Go to Project->Settings->Tricentis Services and fill out the setting ServerEndpointAddress.

    You need to do this on all machines where you want to create tests and trigger test runs. Alternatively, create project settings to apply the setting to all workspaces connected to the repository.

  6. Create the necessary infrastructure for cloud test artifacts:

    • Check out the project root element. This is an important step! It ensures that Tosca adds all necessary property definitions.

    • In the Execution tab, right-click the Execution folder and select Create ElasticExecutionGridEvents folder from the mini toolbar. You only need to do this once.

And that's it!

To set up the test execution integration with Tosca Cloud, follow these steps:

  1. In Tosca Cloud, go to User menu-> Settings-> Integrations, find the Elastic Execution Grid integration, and select Set up integration. Here, you'll find the client secret (opens in new tab) and other information you'll need for future setup steps.

  2. In Tosca on-premises, create an AOS workspace. An AOS workspace is a "background" workspace that gives AOS access to all necessary test artifacts in the repository.

  3. Configure AOS for the integration: 

  4. Open a workspace in Tosca Commander.

  5. Configure the connection between Tosca client and Tosca Gateway Service. Go to Project->Settings->Tricentis Services and fill out the setting ServerEndpointAddress.

    You need to do this on all machines where you want to create tests and trigger test runs. Alternatively, create project settings to apply the setting to all workspaces connected to the repository.

  6. Create the necessary infrastructure for cloud test artifacts:

    • Check out the project root element. This is an important step! It ensures that Tosca adds all necessary property definitions.

    • In the Execution tab, right-click the Execution folder and select Create ElasticExecutionGridEvents folder from the mini toolbar. You only need to do this once.

And that's it!

What's next

Now that you've set up Tosca on-premises for the integration, complete the integration in Tosca Cloud. Specifically, you need to prepare the machines that should run your tests. For details, check out this infrastructure topic (opens in new tab) in the Tosca Cloud manual.

Already all set up? In this case, your team can start to prepare and trigger test runs.