Agent directive in Jenkins - Mini Project: Build & Apply

Using the Jenkins Agent Directive

📖 Scenario: You are setting up a Jenkins pipeline to run your build steps on a specific agent. This helps Jenkins know where to run your tasks, like choosing a particular machine or environment.

🎯 Goal: Build a Jenkins pipeline script that uses the agent directive to specify the node where the pipeline should run.

📋 What You'll Learn

Create a Jenkins pipeline script with a pipeline block

Use the agent directive to specify the node label linux

Add a simple stage with a steps block that echoes a message

Print the message to confirm the pipeline runs on the specified agent

💡 Why This Matters

🌍 Real World

In real projects, specifying the agent ensures your build runs on the right machine with needed tools.

💼 Career

Knowing how to use the Jenkins agent directive is essential for DevOps engineers to manage build environments efficiently.

1

Create the basic Jenkins pipeline structure

Write a Jenkins pipeline script starting with pipeline {} and inside it add an empty agent directive.

Jenkins

pipeline {
    agent {}
    // Your code here
}

Need a hint?

Start with the pipeline block and add an empty agent directive inside it.

2

Specify the agent node label

Modify the agent directive to specify the node label linux using agent { label 'linux' }.

Jenkins

pipeline {
    agent { label 'linux' }
    // Your code here
}

Need a hint?

Use agent { label 'linux' } to tell Jenkins to run on the node labeled 'linux'.

3

Add a stage with a simple echo step

Inside the pipeline block, add a stage named 'Build' with a steps block that runs echo 'Building on linux agent'.

Jenkins

pipeline {
    agent { label 'linux' }
    stage('Build') {
        steps {
            // Your code here
        }
    }
}

Need a hint?

Add a stage with name 'Build' and inside steps use echo to print the message.

4

Print the pipeline output

Run the pipeline script and ensure it prints Building on linux agent in the console output.

Jenkins

pipeline {
    agent { label 'linux' }
    stage('Build') {
        steps {
            echo 'Building on linux agent'
        }
    }
}
// Run the pipeline and check output

Need a hint?

Run the pipeline in Jenkins and look for the message Building on linux agent in the console output.