Running Jenkins automation suites from Helix ALM

You can run an automation suite to build the Jenkins project selected for a suite from Helix ALM. If you use the Jenkins plugin, the build results are submitted to Helix ALM.

Although you may have builds automatically scheduled to run in Jenkins, you may want to run an automation suite from Helix ALM to test the configuration with Jenkins to make sure it works as expected or rerun a single failed build to troubleshoot.

Before running a suite

Before you can run an automation suite from Helix ALM, you need to:

Add Jenkins configuration to the Helix ALM project that contains connection information for Jenkins. See Adding Jenkins configurations.
Add a run configuration to the automation suite to specify the Jenkins project the suite will run and any build parameters. See Working with run configurations in automation suites.
To submit build and test results back to Helix ALM, configure the Helix ALM Test Management plugin in Jenkins. We highly recommend using the plugin so you can easily review results in Helix ALM. See Using the Helix ALM Test Management Jenkins plugin.
To automatically associate test results with test cases in Helix ALM, see Automatically associating automated test results with test cases.

Running a suite

1. Click Automation Suites in the left navigation area.

The Automation Suites list opens.

2. Select the suite to run and click Run Suite. You can also run the suite when you are viewing the suite Details tab.

The Run Jenkins Automation Suite dialog box opens. You may be prompted to enter your Jenkins credentials. See Entering Jenkins credentials when working with automation suites.

3. Select a Test run set to group the tests in.

If a test run set is configured in the Jenkins post-build step configured for the suite, the test run set you select here is used instead of the set selected in Jenkins.

4. If the Jenkins project uses parameters, they are displayed in Build Parameters area. Change any of the parameters to use different values for the build.

Credentials, Password, Run, and Jenkins plugin-specific parameters have a dropdown list. Select Enter value to enter a parameter value to use for the build. Select Use default from Jenkins to use the default value set in the Jenkins project.

5. Click Run.

Helix ALM sends a request to Jenkins to start the build. If the build starts, the Run Jenkins Automation Suite dialog box closes. If the build does not start, errors are displayed.

You can monitor the build status on the suite Builds tab. See Viewing build summary information in automation suites.