Using the Perforce ALM Jenkins Plugin
To automatically submit automated test results from Jenkins to Perforce ALM, we recommend using the Perforce ALM Jenkins Plugin. After builds run in Jenkins, the plugin parses test result files and automatically uploads results data to ALM using the ALM REST API.
You can review automated build and test results using the ALM web client.
Jenkins Freestyle projects and Pipeline are supported. JUnit and XUnit XML report files are supported.
To configure and use the plugin, you should be familiar with using Jenkins as a continuous integration (CI) tool. Perforce does not provide support for using Jenkins. If you need additional help with Jenkins and using the plugin, contact Perforce Services.
On this page:
Requirements
- Latest stable Jenkins version. Must be 2.289.3 or later.
- Perforce ALM 2022.2 Server or later
- Perforce ALM REST API 2022.2 or later. Installed with the Perforce ALM Server.
Installation and configuration overview
Before Jenkins can submit test results to ALM, you must complete the following setup tasks:
3. Add post-build steps to your Freestyle projects or Pipeline to submit test results to ALM when a build completes.
4. Modify your test scripts to ensure test results files include information to associate build and test results with automation suites in ALM.
Running tests and viewing results
After the installation and configuration tasks are complete, you can run a build in Jenkins and view information about the build and tests in ALM.