Idempotent pipeline steps in Jenkins - Mini Project: Build & Apply

Idempotent pipeline steps

📖 Scenario: You are working on a Jenkins pipeline for a software project. You want to make sure that certain steps in the pipeline can run multiple times without causing errors or unwanted side effects. This is called making the steps idempotent. For example, creating a directory should not fail if the directory already exists.

🎯 Goal: Build a Jenkins pipeline script with idempotent steps that safely create a directory, set a configuration variable, and print the final status.

📋 What You'll Learn

Create a directory only if it does not exist

Set a configuration variable for the directory path

Use a pipeline step that checks the directory existence before creating it

Print the final directory path to confirm the setup

💡 Why This Matters

🌍 Real World

In real projects, pipelines often run multiple times. Making steps idempotent avoids errors like trying to create something that already exists.

💼 Career

Understanding idempotent steps is important for DevOps engineers to build reliable and repeatable CI/CD pipelines.

1

Create a directory path variable

Create a variable called dirPath and set it to "/tmp/myapp" in the Jenkins pipeline script.

Jenkins

# Create a variable called dirPath and set it to "/tmp/myapp"
# Your code here

Need a hint?

Use def to declare a variable in Jenkins pipeline scripts.

2

Add a configuration variable for idempotency

Add a variable called dirExists that checks if the directory at dirPath exists using fileExists(dirPath).

Jenkins

def dirPath = "/tmp/myapp"
# Add a variable dirExists that checks if dirPath exists
# Your code here

Need a hint?

Use the Jenkins pipeline step fileExists(path) to check if a file or directory exists.

3

Create the directory only if it does not exist

Use an if statement to check if dirExists is false, and inside it use sh to run mkdir -p ${dirPath} to create the directory.

Jenkins

def dirPath = "/tmp/myapp"
def dirExists = fileExists(dirPath)
# If dirExists is false, create the directory using sh 'mkdir -p ${dirPath}'
# Your code here

Need a hint?

Use if (!dirExists) to check if the directory does not exist, then create it with sh.

4

Print the directory path to confirm

Add a echo statement to print "Directory path is: ${dirPath}".

Jenkins

def dirPath = "/tmp/myapp"
def dirExists = fileExists(dirPath)
if (!dirExists) {
    sh "mkdir -p ${dirPath}"
}
# Print the directory path using echo
# Your code here

Need a hint?

Use echo to print messages in Jenkins pipeline scripts.