Why notifications matter in Jenkins - See It in Action

Why notifications matter

📖 Scenario: You are managing a Jenkins pipeline that builds and tests software. You want to make sure your team knows immediately if the build fails or succeeds. Notifications help keep everyone informed and reduce delays in fixing problems.

🎯 Goal: Build a simple Jenkins pipeline script that sends notifications when the build status changes. You will create the pipeline steps, add a notification configuration, implement the notification logic, and finally display the notification message.

📋 What You'll Learn

Create a Jenkins pipeline with a build stage

Add a variable to hold the notification message

Use a post block to send notifications on build success or failure

Print the notification message at the end

💡 Why This Matters

🌍 Real World

In real projects, notifications keep the team informed about build results quickly, so they can fix issues or proceed with deployments without delay.

💼 Career

Understanding Jenkins notifications is essential for DevOps engineers to maintain smooth CI/CD pipelines and improve team communication.

1

Create a Jenkins pipeline with a build stage

Write a Jenkins pipeline script that defines a pipeline with an agent any and a stage named Build that runs a simple shell command echo "Building project".

Jenkins

// Your code here

Hint

Start with pipeline { agent any stages { stage('Build') { steps { sh 'echo "Building project"' } } } }

2

Add a variable to hold the notification message

Add a def variable called notificationMessage at the top of the pipeline script and set it to an empty string ''.

Jenkins

def notificationMessage = ''

pipeline {
    agent any
    stages {
        stage('Build') {
            steps {
                sh 'echo "Building project"'
            }
        }
    }
}

// Your code here

Hint

Define def notificationMessage = '' before the pipeline block.

3

Use a post block to send notifications on build success or failure

Inside the pipeline block, add a post section with success and failure blocks. Set notificationMessage to 'Build succeeded!' on success and 'Build failed!' on failure.

Jenkins

def notificationMessage = ''

pipeline {
    agent any
    stages {
        stage('Build') {
            steps {
                sh 'echo "Building project"'
            }
        }
    }
    // Add post block here
}

// Your code here

Hint

Use post { success { script { notificationMessage = 'Build succeeded!' } } failure { script { notificationMessage = 'Build failed!' } } }

4

Print the notification message at the end

Add a post block with an always section that prints the notificationMessage using echo.

Jenkins

def notificationMessage = ''

pipeline {
    agent any
    stages {
        stage('Build') {
            steps {
                sh 'echo "Building project"'
            }
        }
    }
    post {
        success {
            script {
                notificationMessage = 'Build succeeded!'
            }
        }
        failure {
            script {
                notificationMessage = 'Build failed!'
            }
        }
        // Add always block here
    }
}

// Your code here

Hint

Use post { always { echo "${notificationMessage}" } } to print the message.

Practice

1. Why are notifications important in Jenkins pipelines?

easy

A. They increase the build time significantly.

B. They slow down the pipeline execution.

C. They delete old build logs automatically.

D. They alert the team about pipeline successes or failures quickly.

Solution

1. Step 1: Understand the purpose of notifications

   Notifications inform the team about important events like build success or failure.

2. Step 2: Identify the benefit of quick alerts

   Quick alerts help the team react fast to fix issues or celebrate success.

3. Final Answer:

   They alert the team about pipeline successes or failures quickly. -> Option D

4. Quick Check:

   Notifications = Quick alerts [OK]

Hint: Notifications = Fast alerts about pipeline status [OK]

Common Mistakes:

• Thinking notifications slow down builds
• Confusing notifications with log cleanup
• Believing notifications increase build time

2. Which Jenkins plugin is commonly used to send notifications to Slack?

easy

A. Email Extension Plugin

B. Slack Notification Plugin

C. Git Plugin

D. Docker Plugin

Solution

1. Step 1: Identify notification plugins in Jenkins

   Jenkins has specific plugins for different notification methods.

2. Step 2: Match Slack notifications to the correct plugin

   The Slack Notification Plugin is designed to send messages to Slack channels.

3. Final Answer:

   Slack Notification Plugin -> Option B

4. Quick Check:

   Slack notifications = Slack Notification Plugin [OK]

Hint: Slack notifications use Slack Notification Plugin [OK]

Common Mistakes:

• Choosing Email Extension Plugin for Slack
• Confusing Git Plugin with notification plugins
• Selecting unrelated plugins like Docker Plugin

3. Given this Jenkins pipeline snippet:

pipeline {
  agent any
  stages {
    stage('Build') {
      steps {
        echo 'Building...'
      }
    }
  }
  post {
    failure {
      mail to: '[e-mail]', subject: 'Build Failed', body: 'Please check the build.'
    }
  }
}

What happens when the build fails?

medium

A. An email is sent to [e-mail] notifying the failure.

B. The pipeline retries the build automatically.

C. The build logs are deleted.

D. Nothing happens; no notification is sent.

Solution

1. Step 1: Analyze the post-failure block in the pipeline

   The post block with failure condition sends an email with specified details.

2. Step 2: Understand the email step

   The mail step sends an email to '[e-mail]' with subject and body on failure.

3. Final Answer:

   An email is sent to [e-mail] notifying the failure. -> Option A

4. Quick Check:

   Failure triggers email notification [OK]

Hint: Post failure block sends email notification [OK]

Common Mistakes:

• Assuming automatic retry on failure
• Thinking logs get deleted on failure
• Believing no notification is sent

4. You added this notification step in Jenkins:

post {
  success {
    slackSend channel: '#dev', message: 'Build succeeded!'
  }
}

But no Slack message is sent after a successful build. What is the likely cause?

medium

A. Slack messages only send on failure, not success.

B. The pipeline syntax is incorrect and causes failure.

C. Slack plugin is not installed or configured properly.

D. The channel name must start with '@' not '#'.

Solution

1. Step 1: Check plugin installation and configuration

   Slack notifications require the Slack plugin installed and configured with credentials.

2. Step 2: Verify syntax and channel format

   The syntax is correct and channel names start with '#', so these are not the issue.

3. Final Answer:

   Slack plugin is not installed or configured properly. -> Option C

4. Quick Check:

   No Slack message = Plugin/config issue [OK]

Hint: Check Slack plugin and config if no messages sent [OK]

Common Mistakes:

• Assuming syntax error without checking plugin
• Thinking Slack only sends failure messages
• Confusing channel prefix '@' with '#'

5. You want Jenkins to notify your team only when a build fails twice in a row. Which approach best achieves this?

hard

A. Use a plugin or script to track consecutive failures and send notification only after two failures.

B. Send notifications on every build success and failure.

C. Disable notifications and check build status manually.

D. Send notifications only on the first failure, ignoring subsequent failures.

Solution

1. Step 1: Understand the requirement for consecutive failure notifications

   Notifications should trigger only after two failures in a row, not every failure.

2. Step 2: Identify how to track consecutive failures

   Using a plugin or custom script can track build history and send notifications accordingly.

3. Final Answer:

   Use a plugin or script to track consecutive failures and send notification only after two failures. -> Option A

4. Quick Check:

   Consecutive failure alert = Plugin/script tracking [OK]

Hint: Track consecutive failures with plugin/script for notifications [OK]

Common Mistakes:

• Sending notifications on every build regardless
• Ignoring the need to track failure history
• Disabling notifications and missing alerts