Skip to main content

Running tests over mabl Link

Molly Exten
  • Updated

With mabl Link, you can securely run tests from the mabl cloud against applications in private networks. Once the mabl Link Agent is set up to create a secure tunnel to the mabl cloud, you can configure your mabl workspace for testing over mabl Link.

This article explains how to…

Routing test traffic through mabl Link

Before configuring tests to run over mabl Link, make sure the Link Agent has a "Connected" status on the networking page in the app: Settings > Networking. If you do not see an active Link Agent, refer to the articles on Link Agent setup and troubleshooting mabl Link issues for more details.

mabl Link is configured at the environment level. When you associate a Link Agent with an environment, all plans associated with that environment will have their traffic routed through the selected Link Agent. If only some of your testing environments are private, create a dedicated environment in mabl for the tests that require access through mabl Link. 

Add Link to an existing environment

To configure an existing environment to use mabl Link, go to the environments page - Configuration > Environments - and take the following steps.

  1. Open the environment you want to use for mabl Link.
  2. Click on the edit pencil.
  3. Check the "Use Link Agent" box.
  4. Select the Link Agent from the dropdown menu.
  5. Save your settings.
Configuring mabl Link for an environment

Routing test traffic through mabl Link

Add Link to a new environment

To create a new environment that uses mabl Link, go to the environments page - Configuration > Environments - and take the following steps:

  1. Click on + Add environment.
  2. Give your environment a name.
  3. Check the "Use Link Agent" box.
  4. Select the Link Agent from the dropdown menu.
  5. Save your settings.

mabl Link in test output

When tests run in the mabl cloud, the URLs are resolved by the Link Agent host in your network. At the start of test output, tests running over mabl Link show a log line similar to this:

Found active mabl Link with name "{link-agent-name}"

If there are issues with your Link-enabled test and plan runs, see the article on troubleshooting mabl Link for tips on how to isolate the issue.

Disabling mabl Link for a test environment

To stop routing test traffic through mabl Link, disable the Link Agent at the environment level:

  1. Go to the environments page in the mabl app: Configuration > Environments
  2. Open the environment you want to update.
  3. Click on the edit pencil to open the "Edit environment" page.
  4. Uncheck the "Use Link Agent" box.
  5. Save your settings.

Tests and plans that run in this environment will no longer connect to the application under test through mabl Link. Addresses will be resolved in the mabl cloud.

Overriding the Link Agent name in a deployment event

In some scenarios, such as when a developer needs to test against a local development environment, it may be necessary to temporarily override the Link Agent used for some tests and plans. With mabl deployment events, you can dynamically override the configured Link Agent for an environment by passing a new Link Agent name.

To override the Link Agent used in a deployment event, add the following parameter to the JSON request body:

"plan_overrides":{"link_agent_labels":"your-agent-name-here"}

Related articles