About
Jenkins is a build management application that allows you to automate repetitive tasks like getting source code from a source code control, building projects, running automated tests, and so on.
You can include your cross-platform web tests into your workflow managed and automated with Jenkins in several ways:
-
By using the TestComplete support plugin.
-
By running tests from the command line.
The most convenient way is using the TestComplete support plugin, so we will describe it in detail in this section.
Requirements
-
Jenkins version 2.121.1 or later.
-
The TestComplete Support plugin must be installed in Jenkins. For the instructions, see below.
-
A Jenkins node that you will use as a test workstation. The node must meet the following requirements:
- One of the supported Windows versions must be installed on the node.
- A test runner tool that allows running cross-platform tests in parallel must be installed on the node. To learn how to get the tool, see Getting Installation Package.
Note: You do not need to have the tool installed on devices in your device cloud.
- The node must have access to your license manager.
- The node must have access to your device cloud where you will run your cross-platform web tests.
- The node must have access to your TestComplete project that contains your cross-platform web tests.
-
Your TestComplete project must be prepared for running cross-platform web tests.
If you use CrossBrowserTesting as your device cloud provider, your TestComplete project must be able to access your CrossBrowserTesting.com account. To learn more, see the Cross-Platform Web Tests in the TestComplete documentation.
Install TestComplete Support plugin
Online installation
-
In Jenkins, go to Manage Jenkins > Manage Plugins.
-
Switch to the Available tab.
-
Find TestComplete support plugin and click Install without restart.
Tip: Press Ctrl+F and search through the page for TestComplete keyword to find the plugin faster.
Offline installation
-
Download a TestComplete Support Plugin .hpi file from plugins.jenkins.io/TestComplete.
-
In Jenkins, go to Manage Jenkins > Manage Plugins.
-
Switch to the Advanced tab.
-
Click Choose File in the Upload Plugin section.
-
Select the plugin file on your device.
-
Click Upload.
How it works
Cross-platform web tests you create with TestComplete can run in device clouds managed with Selenium Grid. It can be:
-
SmartBear device cloud solution — CrossBrowserTesting.com.
-
A private hub with Selenium Grid configured on your local computer or on a remote computer in your network. To learn more about installing and configuring Selenium Grid, see selenium.dev.
Selenium Grid allows distributing tests among devices (Selenium nodes); it is a common task to run your tests in parallel, with each test running on a separate device.
To run your cross-platform web tests in parallel, you use a test runner tool that allows several instances of it to run on the same workstation. To control the tool from your Jenkins pipeline, use the TestComplete Test step provided by the TestComplete Support plugin:
Click the image to enlarge it.
Where to go next
To learn how to configure a pipeline to run several cross-platform web tests in parallel:
Configuring Jenkins Pipelines to Run Cross-Platform Web Tests in Parallel
For information on the Pipeline syntax of the TestComplete Test step:
TestComplete Test Step Pipeline Syntax for Parallel Test Runs