Working with run configurations in automation suites

If you want to run builds for a Jenkins project from an automation suite in Perforce ALM, configure a run configuration for the suite. The run configuration specifies the Jenkins configuration, project, and the default parameter values to use when running the build.

If you do not use Jenkins or will only run builds from within Jenkins, you do not need configure a run configuration for the suite.

See Running Jenkins automation suites from ALM for information.

1. Make sure that the ALM project has a Jenkins configuration for the instance to connect to from the suite. See Adding Jenkins configurations.

2. Click Automation Suites in the left navigation area.

The Automation Suites list opens.

3. Select the suite, click Actions, and choose Edit. You can also click the suite name or number.

The suite page opens with the Details tab selected. You can only edit information on the Details tab, not the Summary or Builds tabs.

Click an area to expand or collapse it. Click the Expand All button to expand all areas or the Collapse All button to collapse expanded areas at the top of the page.

4. Go to the Run Configuration area.

If the suite already has a run configuration, it is displayed. If the ALM project does not have a Jenkins configuration, 'No integrations with automated testing products have been configured' is displayed. See Adding Jenkins configurations for information about adding configurations.

Overriding default parameter values

If the selected Jenkins project has parameters configured, they are displayed in the Default Parameter Values area. These parameters are used when running the automation suite from ALM in Jenkins. The parameter name, default value and description are displayed. If there are multiple parameters with the same name in the Jenkins project, only the last one is displayed.

All parameter types are supported except File parameters. The method to enter or select parameter values may be different than in Jenkins.

If the default parameter if changed to a different type or if the overridden value in ALM is no longer valid, and you are editing the suite, the Default Parameters Changed dialog box opens. A list of the changed parameters is displayed. Any default value overrides for the changed parameters are no longer valid. Click Close to close the dialog box.

You can override a default parameter value and use a different value when the automation suite runs.

1.Click Override next to the parameter.

2. Enter or select the parameter value to use.

3. If you want to go back to using the default parameter, click Use default.

Removing a run configuration from a suite

If you no longer want to use a run configuration for the automation suite, you can remove it.

1.Click Remove Run Configuration.

You are prompted to confirm the removal. There is no undo available.

2. Click Remove.

The run configuration is removed. You cannot run the suite in Jenkins unless you add a run configuration to it again.