IBM Cloud Docs
Configuring Sauce Labs

Configuring Sauce Labs

Sauce Labs runs functional unit tests. When a Sauce Labs test suite is configured as a test job in the Delivery Pipeline, the test suite can run tests against your web or mobile app as part of your continuous delivery process. These tests can provide valuable flow control for your projects, acting as gates to prevent the deployment of bad code.

This tool integration is available only on IBM Cloud Public.

Configure Sauce Labs to run automated functional tests on multiple operating systems and browsers so that you can emulate the way that a user might use a website or an application:

  1. If you are configuring this tool integration as you are creating the toolchain, in the Configurable Integrations section, click Sauce Labs.

  2. If you have a toolchain and are adding this tool integration to it, from the IBM Cloud console, click the menu icon hamburger icon and select DevOps. On the Toolchains page, click the toolchain to open its Overview page. Alternatively, on your app's Overview page, on the Continuous delivery card, click View toolchain. Then, click Overview.

    a. Click Add tool.

    b. In the Tool Integrations section, click Sauce Labs.

  3. Type the user name that is associated with your Sauce Labs account. You can find your user name in the welcome message on your Sauce Labs account page.

  4. Type the access key for your Sauce Labs account. You can find the key on your Sauce Labs account page.

  5. Click Create Integration.

  6. On your Toolchain's Overview page, on the Third-Party tools card, click Sauce Labs to go to saucelabs.com and view the test activity for the toolchain.

If you added a Sauce Labs test job to the Delivery Pipeline, you can select the service instance. For instructions to configure a test job in your pipeline, see the Configuring a Sauce Labs test job in your pipeline section.

Configuring Sauce Labs by using the API

The Sauce Labs tool integration supports the following configuration parameters that you can use with the Toolchain HTTP API and SDKs when you create, read, and update tool integrations.

You must specify the tool_type_id property in the request body with the saucelabs value.

Table 1. Sauce Labs tool integration parameters
Parameter Usage Type Terraform argument Description
key required, updatable Password access_key The access key for the Sauce Labs account. You can use a toolchain secret reference for this parameter. For more information about secret references, see Protecting your sensitive data in Continuous Delivery.
username required, updatable String username The username of the Sauce Labs account.