Over a million developers have joined DZone.

Spring Boot Integration Test With Cucumber and Jenkins Pipeline

DZone's Guide to

Spring Boot Integration Test With Cucumber and Jenkins Pipeline

Learn how to integrate the Cucumber framework with Spring Boot integration tests and collect reports in a Jenkins pipeline for behavior-driven testing.

· DevOps Zone ·
Free Resource

Is the concept of adopting a continuous everything model a daunting task for your fast moving business? Read this whitepaper to break down and understand one of the key pillars of this model in Continuous Governance: The Guardrails for Continuous Everything.

Here I am sharing how you can integrate Cucumber for behavior driven testing with Spring Boot integration tests, and how you collect the reports in Jenkins pipeline.

In a sample Spring Boot app generated from my custom Spring Boot archetype, we will show a small integration test suite with Cucumber and Spring Boot.

Steps to Follow

1- Add Cucumber maven dependencies to your Spring Boot pom.xml

 <!-- Cucumber-->

2- Define Cucumber features in your test resources:

Screen Shot 2017-12-03 at 19.00.06

3- How to define the features implementation to be executed with your Spring Boot app logic:

  • The feature description:

Feature: the health can be retrieved
  Scenario: client makes call to GET /health
    When the client calls /health
Then the client receives response status code of 200

  • The feature implementation:

 * how the feature is executed
public class GetHealthStep extends CucumberRoot {
    private ResponseEntity<String> response; // output

    @When("^the client calls /health$")
    public void the_client_issues_GET_health() throws Throwable {
        response = template.getForEntity("/health", String.class);

    @Then("^the client receives response status code of (\\d+)$")
    public void the_client_receives_status_code_of(int statusCode) throws Throwable {
        HttpStatus currentStatusCode = response.getStatusCode();
        assertThat("status code is incorrect : " +
                response.getBody(), currentStatusCode.value(), is(statusCode));


4- How to execute the integration test:

You need to configure the root executor with Cucumber runner as the following:

 * the main class for cucumber where you configure where the features are defined and which formats of reports needed to be generated
@CucumberOptions(features = {"src/test/resources/features"}, format = {"pretty", "html:target/reports/cucumber/html",
        "json:target/cucumber.json", "usage:target/usage.jsonx", "junit:target/junit.xml"})
public class CucumberIntegrationIT {

The integration test triggering which will be done via spring boot integration test:

 * main spring boot integration test with integration test profile
@SpringBootTest(classes = Application.class, webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
public class CucumberRoot {

    protected TestRestTemplate template;

    public void before() {
        // demo to show how to add custom header Globally for the http request in spring test template , like  user header
        template.getRestTemplate().setInterceptors(Collections.singletonList((request, body, execution) -> {
                    .add("userHeader", "user");
            return execution.execute(request, body);

5- How to collect the test reports in the Jenkins pipeline: 

stage('Integration tests') {
            // Run the maven build
            steps {
                script {
                    def mvnHome = tool 'Maven 3.3.9'
                    if (isUnix()) {
                      // to skip unit testing execution
                        sh "'${mvnHome}/bin/mvn'  verify -Dunit-tests.skip=true"
                    } else {
                        bat(/"${mvnHome}\bin\mvn" verify -Dunit-tests.skip=true/)

              // here cucumber extension will collect the reports for you
                cucumber buildStatus: null, fileIncludePattern: '**/cucumber.json', jsonReportDirectory: 'target', sortingMethod: 'ALPHABETICAL'

The complete working sample is here:

GitHub: https://github.com/Romeh/spring-boot-sample-app


  1. Cucumber: https://cucumber.io/
  2. Spring Boot: https://projects.spring.io/spring-boot/

Are you looking for greater insight into your software development value stream? Check out this whitepaper: DevOps Performance: The Importance of Measuring Throughput and Stability to see how CloudBees DevOptics can give you the visibility to improve your continuous delivery process.

spring boot ,cucumber ,integration test ,jenkins pipeline

Published at DZone with permission of

Opinions expressed by DZone contributors are their own.

{{ parent.title || parent.header.title}}

{{ parent.tldr }}

{{ parent.urlSource.name }}