Jenkins CI plugins for Gatling Open-Source and Enterprise
Thanks to this plugin, you can track a Gatling simulation launched by the Maven plugin in Jenkins.
Getting Gatling Jenkins plugin
Gatling Jenkins plugin is available in Jenkins plugin manager.
You can also get Gatling Jenkins plugin as a
.hpi file here.
Source code is hosted in a dedicated project: gatling-plugin.
Installing Gatling Jenkins plugin in Jenkins
You can install the plugin manually by following the official Jenkins documentation here.
Jenkins plugin usage
Documentation of Gatling Jenkins plugin is available on the jenkins.io website.
How it works
Even if the Jenkins plugin was built with the Maven plugin in mind, using it is not mandatory to be able to archive reports and track your results with the Jenkins plugin.
The Jenkins plugin looks into your job’s workspace for any simulation report it can find, and archives only reports that hasn’t been archived yet (meaning that you don’t need to clean your workspace to delete previous reports).
As long as you are able to configure a job that will launch Gatling, execute a simulation and generate a report in your job’s workspace (using the Maven plugin, SBT, a shell script or whatever), you’re good to go!
However, note that the Jenkins plugin relies on the report folder’s naming convention runname-rundate (ex: mysimulation-201305132230). You must not change the report folder’s name in order to get the Jenkins plugin to work.
Using Jenkins with Gatling Enterprise
Gatling Enterprise has a dedicated Jenkins plugin. This plugin can launch a Gatling Enterprise simulation and display live metrics.
Please refer to the Gatling Enterprise documentation for installing this plugin on Cloud or Self-hosted.