Failing builds on test failures in Jenkins - Mini Project: Build & Apply

Failing Builds on Test Failures in Jenkins

📖 Scenario: You are working as a DevOps engineer for a software team. Your team uses Jenkins to automate building and testing their code. To keep the code quality high, you want Jenkins to stop the build process and mark it as failed whenever any test fails.This helps the team quickly find and fix problems before the code is released.

🎯 Goal: Set up a Jenkins pipeline script that runs tests and fails the build if any test fails.You will create a simple Jenkinsfile that runs a test command and marks the build as failed if tests do not pass.

📋 What You'll Learn

Create a Jenkins pipeline script with a pipeline block

Add a stage named Test that runs a test command

Use the sh step to run exit 1 to simulate a test failure

Make sure the build fails when the test command fails

Print a message indicating the build failed due to test failure

💡 Why This Matters

🌍 Real World

In real software projects, automated tests run on every code change. Jenkins pipelines help catch test failures early by failing the build immediately.

💼 Career

DevOps engineers and build managers use Jenkins pipelines to automate testing and ensure only good code is deployed. Knowing how to fail builds on test failures is essential.

1

Create a basic Jenkins pipeline

Create a Jenkins pipeline script with a pipeline block and an agent any directive.

Jenkins

pipeline {
    agent any
    // Your code here
}

Need a hint?

The pipeline block is the main structure. agent any tells Jenkins to run on any available agent.

2

Add a Test stage with a failing command

Inside the pipeline block, add a stages block with a stage named Test. Inside this stage, use the sh step to run exit 1 to simulate a test failure.

Jenkins

pipeline {
    agent any
    stages {
        stage('Test') {
            steps {
                // Your code here
            }
        }
    }
}

Need a hint?

The sh step runs shell commands. exit 1 simulates a failing test.

3

Add a post block to handle failure

Add a post block inside the pipeline block. Inside post, add a failure block that uses echo to print 'Build failed due to test failure.'.

Jenkins

pipeline {
    agent any
    stages {
        stage('Test') {
            steps {
                sh 'exit 1'
            }
        }
    }
    // Your code here
}

Need a hint?

The post block runs steps after the pipeline stages. The failure block runs only if the build fails.

4

Print the failure message on build failure

Run the pipeline script. The build should fail because of exit 1. The console output should include Build failed due to test failure.. Write a echo statement inside the failure block to print this message.

Jenkins

pipeline {
    agent any
    stages {
        stage('Test') {
            steps {
                sh 'exit 1'
            }
        }
    }
    post {
        failure {
            // Your code here
        }
    }
}

Need a hint?

When the test command fails, Jenkins marks the build as failed and runs the failure block to print the message.