Bamboo Plugin

Run your Gatling Enterprise simulations from your Bamboo CI.

Purpose of this plugin

This plugin enables you to start a Gatling Enterprise simulation directly from your Bamboo platform. This plugin links a Bamboo job with one Gatling Enterprise simulation.

This plugin doesn’t create a new Gatling Enterprise simulation, you have to create it using the Gatling Enterprise Dashboard before.

Installation

To download the plugin, you need to get the jar file located at:

https://downloads.gatling.io/releases/frontline-bamboo-plugin/1.16.6/frontline-bamboo-plugin-1.16.6.jar

You need to be connected as an administrator of your Bamboo application to install it. Go Bamboo Administration, Manage Apps, Upload app, and choose the jar file.

Installation

Configuration

The plugin needs some global configuration. Go to Administration, then Global variables.

Add two new variables:

  • The first one is named frontline.address, and corresponds to the address of your Gatling Enterprise, for example: https://cloud.gatling.io
  • The second one is named frontline.apiTokenPassword, and corresponds to the API token needed to authenticate to Gatling Enterprise. The API token needs the All role.
Global variable

Job set-up

Job configuration

Add a new build task called Gatling Enterprise. Choose in the Gatling Enterprise Simulation list the simulation you want to use.

Task configuration

JUnit reporting

You can display the results of the Gatling Enterprise assertions with the JUnit Parser plugin.

Add a new build task called JUnit Parser and fill the Specify custom results directories input with the following line:

**/gatlingFrontLineJunitResults/*.xml

JUnit configuration

Usage

A new Gatling Enterprise simulation will be started every time the job is run. Check the logs to check the simulation progress. If the simulation ran successfully, it will look like the following:

Console output

If the Gatling Enterprise deployment fails (i.e. because of a shortage of available hosts), the plugin will retry 3 times to redeploy the simulation.

Live metrics will be displayed in the console, and in the build summary.

Results

Edit this page on GitHub