Bamboo Plugin

Integrate your simulations to your Bamboo CI.

Purpose of this plugin

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

This plugin doesn’t create a new Gatling FrontLine simulation, you have to create it using the FrontLine 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.13.3/frontline-bamboo-plugin-1.13.3.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 FrontLine, for example: https://demo-beta.gatling.io
  • The second one is named frontline.apiTokenPassword, and corresponds to the token needed to authenticate to Gatling FrontLine. To fetch it, refer to the section Managing API Tokens in the FrontLine User Guide.
Global variable

Job set-up

Job configuration

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

Task configuration

JUnit reporting

You can display the results of the Gatling FrontLine 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 FrontLine 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 FrontLine 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