Preparing Jenkins for Running TestComplete Tests

Applies to TestComplete 15.62, last modified on March 19, 2024

To use Jenkins to run TestComplete tests, install the TestComplete Support plugin and configure Jenkins nodes.

1. Install TestComplete Support plugin

Online installation

  1. In Jenkins, go to Manage Jenkins > Manage Plugins.

  2. Switch to the Available tab.

  3. Start typing TestComplete in the Search text box. The page will filter out the list of available plugins as you are typing.

  4. Select the TestComplete Support plugin and click Install without restart.

Offline installation

  1. Download a TestComplete Support Plugin .hpi file from the Jenkins Wiki page.

  2. In Jenkins, go to Manage Jenkins > Manage Plugins.

  3. Switch to the Advanced tab.

  4. Click Choose File in the Upload Plugin section.

  5. Select the plugin file on your device.

  6. Click Upload.

When the installation is finished, switch to the Installed tab to make sure that the TestComplete plugin was installed successfully:

2. Configure Jenkins nodes

Jenkins supports running distributed builds, so you can configure your jobs to run TestComplete tests on remote computers. To do this, run the Jenkins agent on remote computers and connect them to Jenkins to register them as Jenkins nodes.

Adding nodes to Jenkins

  1. In Jenkins, go to Managing Jenkins > Manage Nodes and Clouds.

  2. Click New Node.

  3. Enter the name for the new node.

  4. Click Permanent Agent.

  5. Click OK.

  6. In the Remote Root Directory text box, enter the path to the folder on the remote computer, that will be used as a working folder for the Jenkins agent.

  7. Specify other parameters, if needed.

  8. Select the Launch agent by connecting it to the master launch method.

  9. Click Save.

Launching Jenkins agents on nodes and connecting them to Jenkins

  1. Log in to the computer to be used as a Jenkins node.

  2. On the node, run a web browser and open the Manage Nodes page of Jenkins:

    http://<jenkins_server>/computer

  3. Click the target node in the list.

  4. Follow the provided instructions to start the Jenkins agent on the node and connect it to Jenkins:

  5. (Optional) To run the agent as a service, in the Jenkins agent window, click File > Install as a service:

    TestComplete integration with Jenkins: Installing Jenkins agent as Windows service

    If your tests interact with the GUI, configure your TestComplete Test build steps in your Jenkins projects to open an interactive user session in which they will run. To learn how to do that, see the description of the Run interactive user session property of the TestComplete Test build step or the description of the useTCService parameter of the step (for a Pipeline script).

    If no interactive user session is open, your tests will fail.

    To run tests without opening an interactive user session (for example, if they do not interact with the GUI), disable UI accessibility in TestComplete (or TestExecute) on the Jenkins agent.

    View instructions

See Also

Integration With Jenkins
Configuring Jenkins Freestyle Jobs to Run TestComplete Tests
Preparing Jenkins Nodes for Running TestComplete Tests

Highlight search results