The purpose of this plugin is to set up and configure an environment to be able to run Provar Automation Tests with limited manual effort. The plugin allows for automatic installation of the Provar Automation CLI via tool configuration. There is also Global Tool configuration for JDK, ANT, and XVFB (Linux Only) which must be done separately (if not already setup). In the future there will be additional browser installations, more parameters for builds, and ProvarDX support as well.
- In order to use this plugin, you will first need a working Provar Automation project checked into a valid version control system.
- You will also need a properly configured build file. You'll find two examples in the
source-filesdirectory. One is for Test Plan configuration, the other for test folder(s).
- It is always recommended that your Provar Automation project be encrypted prior to check in!
- Minimum Jenkins version required is 2.332.4
- For this plugin to be used, a valid Provar Automation CLI Installation must be specified in the Jenkins
Global Tool Configuration.
- In order for the automatic installers to appear in the Global Tool Configuration, you will need to copy the
sources-files/io.jenkins.plugins.ProvarAutomation.ProvarAutomationInstallerfile into your
$JENKINS_HOME/updatesdirectory. This will require a page refresh to take effect.
- This installer file will be updated to reflect any new publicly available versions of the Provar Automation CLI.
- Latest will always point to the latest Provar Automation CLI version publicly available.
- Alternatively, you can configure an automatic installer using an extract configuration.
- You can configure the plugin to use an existing installation of either the Provar Automation CLI or full Provar Automation.
- Requires Oracle Account in order to install JDK automatically.
- Provar requires the usage of JDK 8.
- Oracle JDK Plugin GitHub
- Recommended version: 1.10.X
- ANT Plugin GitHub
- Note you cannot install XVFB automatically without a valid URL
- Linux Distribution Specific Installations (may require sudo override):
apt-get upgrade && apt-get install
apt-get install xvfb
- Alpine Linux
apk add xvfb-run
- Red Hat
yum install xvfbOR
yum install xorg-x11-server-Xvfb
- XVFB Plugin GitHub
Browser Installations must be handled separately, this plugin assumes you will only be testing browsers that are properly installed and accessible from the PATH
- Provar Automation CLI Version: Whatever version you set here will be installed on the machine if not already installed.
- Provar Version: Provar Installation to use. See above section. The version you select here will be used for the task itself.
- Project Name: The project folder containing the Provar test project. Leave blank if the of your root repository contains the .testproject file. The project path must be relative to the Jenkins workspace directory.
- Build File: Build file to use. If left blank, plugin will look for
ANTdirectory. Otherwise, looks in the
ANTdirectory of the
Project Namefolder for the named build file.
- Test Plan: Test Plan to use. Plugin will look in the
plansdirectory of the Provar Project folder for the named Test Plan. Full relative paths can be used (i.e.
- Test Folder: The Test Folder to include in the test run. Plugin will look in the
testsdirectory of the Provar Automation Project for the folder. Full relative paths can be used (i.e.
- Secrets Password: The Provar Secrets Password used to encrypt/access the Provar Project. This value is kept secret and masked in all logs.
- Browser: The target browser to run your tests on. Browser selected from the picklist must be installed on the machine prior to job execution.
- Environment: The test environment to use. Can be left blank to use the default environment.
- Salesforce Metadata Cache Setting: The cache setting to use when accessing Salesforce Metadata.
- Test Results Path Setting: How the
ANT/Resultsfolder will be handled in subsequent job executions.
- In order to build the project, you will need to follow this guide on how to set up your local environment to build Jenkins plugins.
- In short, you need Java 11 and Maven installed in order to build the project using the command
mvn hpi:hpi. This will generate the *.hpi file needed to install the plugin.
- To install the plugin via the *.hpi file, follow the Jenkins Documentation, starting from the Advanced Installation section.
- Report issues and enhancements in the GitHub issue tracker.
- Additionally, all Provar users should raise a case with the Customer Success team via the Success Portal.
Contributions are always welcome and encouraged! You can contribute by referring to the contribution guidelines.
Licensed under MIT, see LICENSE