Creating reusable pipeline steps in Jenkins - Try It Yourself

Creating reusable pipeline steps

📖 Scenario: You are working on a Jenkins pipeline for a software project. You want to create reusable steps to avoid repeating the same code multiple times. This will make your pipeline cleaner and easier to maintain.

🎯 Goal: Build a Jenkins pipeline script that defines a reusable step called greet which prints a greeting message with a given name. Then use this step twice with different names.

📋 What You'll Learn

Define a reusable step called greet that takes a parameter name

The greet step should print 'Hello, <name>!'

Call the greet step twice with names 'Alice' and 'Bob'

Use declarative pipeline syntax

💡 Why This Matters

🌍 Real World

Reusable pipeline steps save time and reduce errors by avoiding repeated code in Jenkins pipelines.

💼 Career

DevOps engineers often create reusable pipeline steps to maintain clean, efficient CI/CD workflows.

1

Create a basic Jenkins pipeline

Write a Jenkins declarative pipeline with a pipeline block and an empty stages section.

Jenkins

pipeline {
    agent any
    stages {
        // Your code here
    }
}

Hint

Start with pipeline { agent any stages { } structure.

2

Define a reusable step called greet

Inside the pipeline block but outside stages, define a def greet(name) function that prints 'Hello, <name>!'.

Jenkins

pipeline {
    agent any
    stages {
    }

    // Define greet function here
    // Your code here
}

Hint

Use def greet(name) { echo "Hello, ${name}!" } syntax.

3

Call the greet step twice in a stage

Add a stage named GreetUsers inside stages. Inside its steps, call greet('Alice') and greet('Bob').

Jenkins

pipeline {
    agent any
    stages {
        stage('GreetUsers') {
            steps {
                // Call greet function twice here
                // Your code here
            }
        }
    }

    def greet(name) {
        echo "Hello, ${name}!"
    }
}

Hint

Use stage('GreetUsers') { steps { script { greet('Alice'); greet('Bob') } } }.

4

Print the pipeline output

Run the pipeline and print the output of the greet calls. The output should show greetings for Alice and Bob.

Jenkins

pipeline {
    agent any
    stages {
        stage('GreetUsers') {
            steps {
                script {
                    greet('Alice')
                    greet('Bob')
                }
            }
        }
    }

    def greet(name) {
        echo "Hello, ${name}!"
    }
}

// Run the pipeline to see output

Hint

Check the Jenkins console output for the greetings.

Practice

1. What is the main benefit of creating reusable pipeline steps in Jenkins?

easy

A. It automatically fixes syntax errors.

B. It makes the pipeline run faster.

C. It reduces code duplication and simplifies maintenance.

D. It disables pipeline notifications.

Solution

1. Step 1: Understand the purpose of reusable steps

   Reusable steps are designed to avoid repeating the same code multiple times in pipelines.

2. Step 2: Identify the main advantage

   By reusing code, maintenance becomes easier because changes are made in one place, reducing errors and effort.

3. Final Answer:

   It reduces code duplication and simplifies maintenance. -> Option C

4. Quick Check:

   Reusable steps = less duplication [OK]

Hint: Think about saving time and effort by reusing code [OK]

Common Mistakes:

• Confusing speed improvement with code reuse
• Assuming reusable steps fix errors automatically
• Believing reusable steps control notifications

2. Which syntax correctly defines a reusable step named buildApp in a Jenkins pipeline?

easy

A. def buildApp() { echo 'Building app...' }

B. buildApp() { echo 'Building app...' }

C. function buildApp { echo 'Building app...' }

D. step buildApp() { echo 'Building app...' }

Solution

1. Step 1: Recall Groovy function syntax in Jenkins

   Reusable steps are defined as Groovy functions using the def keyword followed by the function name and parentheses.

2. Step 2: Match the correct syntax

   def buildApp() { echo 'Building app...' } uses def buildApp() { ... } which is the correct Groovy function definition.

3. Final Answer:

   def buildApp() { echo 'Building app...' } -> Option A

4. Quick Check:

   Groovy functions start with def [OK]

Hint: Look for 'def' keyword to define functions in Jenkinsfile [OK]

Common Mistakes:

• Omitting 'def' keyword
• Using JavaScript or shell syntax
• Using unsupported keywords like 'step' or 'function'

3. Given the reusable step below, what will be the output when calling buildApp('Test')?

def buildApp(String env) {
  echo "Building for ${env} environment"
}

pipeline {
  agent any
  stages {
    stage('Build') {
      steps {
        script {
          buildApp('Test')
        }
      }
    }
  }
}

medium

A. No output

B. Building for Test environment

C. Error: Missing parameter

D. Building for env environment

Solution

1. Step 1: Understand the function call with parameter

   The function buildApp takes a string parameter env and prints a message including it.

2. Step 2: Substitute the parameter value

   Calling buildApp('Test') replaces ${env} with 'Test', so the output is 'Building for Test environment'.

3. Final Answer:

   Building for Test environment -> Option B

4. Quick Check:

   Parameter substitution = correct output [OK]

Hint: Replace variables with passed arguments to find output [OK]

Common Mistakes:

• Ignoring parameter substitution
• Assuming default or missing parameter error
• Thinking no output occurs without explicit return

4. Identify the error in this reusable step definition:

def deployApp(env) {
  echo "Deploying to ${environment}"
}

pipeline {
  agent any
  stages {
    stage('Deploy') {
      steps {
        script {
          deployApp('production')
        }
      }
    }
  }
}

medium

A. Parameter name mismatch: 'env' vs 'environment' inside echo

B. Missing 'def' keyword before function name

C. Incorrect pipeline syntax: missing agent label

D. Function call missing parentheses

Solution

1. Step 1: Check parameter usage inside function

   The function defines parameter env but uses ${environment} inside the echo, which is undefined.

2. Step 2: Identify the mismatch causing error

   This mismatch causes a runtime error because environment is not declared or passed.

3. Final Answer:

   Parameter name mismatch: 'env' vs 'environment' inside echo -> Option A

4. Quick Check:

   Parameter names must match exactly [OK]

Hint: Match parameter names exactly inside function body [OK]

Common Mistakes:

• Using different variable names inside function
• Omitting 'def' keyword (not the issue here)
• Incorrect pipeline syntax unrelated to function

5. You want to create a reusable step notifyBuild that sends different messages based on build status. Which code snippet correctly implements this using parameters and conditional logic?

hard

A. def notifyBuild(String status) {
match (status) {
'SUCCESS' -> echo 'Build succeeded!'
'FAILURE' -> echo 'Build failed!'
}
}

B. def notifyBuild(status) {
switch (status) {
case 'SUCCESS': echo 'Build succeeded!'
case 'FAILURE': echo 'Build failed!'
}
}

C. def notifyBuild(String status) {
if status = 'SUCCESS' {
echo 'Build succeeded!'
} else {
echo 'Build failed!'
}
}

D. def notifyBuild(String status) {
if (status == 'SUCCESS') {
echo 'Build succeeded!'
} else {
echo 'Build failed!'
}
}

Solution

1. Step 1: Review correct Groovy conditional syntax

   Groovy uses if (condition) { ... } with double equals == for comparison.

2. Step 2: Analyze each option

   def notifyBuild(String status) { if (status == 'SUCCESS') { echo 'Build succeeded!' } else { echo 'Build failed!' } } uses correct parameter typing, if-else structure, and comparison operator.
   def notifyBuild(status) { switch (status) { case 'SUCCESS': echo 'Build succeeded!' case 'FAILURE': echo 'Build failed!' } } misses breaks in switch, causing fall-through.
   def notifyBuild(String status) { match (status) { 'SUCCESS' -> echo 'Build succeeded!' 'FAILURE' -> echo 'Build failed!' } } uses invalid 'match' syntax in Groovy.
   def notifyBuild(String status) { if status = 'SUCCESS' { echo 'Build succeeded!' } else { echo 'Build failed!' } } uses single equals = instead of == in if condition, causing assignment error.

3. Final Answer:

   def notifyBuild(String status) { if (status == 'SUCCESS') { echo 'Build succeeded!' } else { echo 'Build failed!' } } -> Option D

4. Quick Check:

   Use if (condition == value) for Groovy conditionals [OK]

Hint: Use if with double equals (==) for conditions in Groovy [OK]

Common Mistakes:

• Using single equals (=) instead of double (==) in conditions
• Using unsupported 'match' syntax
• Missing breaks in switch causing fall-through