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 by clicking on the following button:

Download Bamboo Plugin

You need to be connected as an administrator of your Bamboo application to install it. Go to 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 Gatling Enterprise (https://cloud.gatling.io if using Gatling Enterprise Cloud).
  • the second one is named frontline.apiTokenPassword, and corresponds to the API token needs to authenticate to Gatling Enterprise:
    • for Gatling Enterprise Cloud, the API token needs the Start permission.
    • for Gatling Enterprise Self-Hosted, 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

This job regularly prints a summary of the run’s current status to the build logs. By default, the summary is printed every 5 seconds the first 12 times (i.e. for the first 60 seconds), and then every 60 seconds. You can configure this behavior (or disable it completely) in the job 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 see the simulation progress. If the simulation ran successfully, it will look like the following:

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.

Console output

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

Results

Edit this page on GitHub