Docker agents for isolation in Jenkins - Mini Project: Build & Apply

Docker Agents for Isolation in Jenkins

📖 Scenario: You are setting up a Jenkins pipeline to run build steps inside isolated Docker containers. This helps keep your builds clean and consistent, like having a fresh workspace every time.

🎯 Goal: Create a Jenkins pipeline script that uses a Docker agent to run a simple shell command inside a container. This will show how Docker agents isolate the build environment.

📋 What You'll Learn

Create a Jenkins pipeline with a pipeline block

Use a agent directive with docker to specify the container image

Add a stage named Run inside Docker

Inside the stage, run a shell command echo "Hello from Docker"

Print the output of the command

💡 Why This Matters

🌍 Real World

Many teams use Jenkins with Docker agents to ensure builds run in clean, repeatable environments without leftover files or dependencies.

💼 Career

Understanding Docker agents in Jenkins is essential for DevOps roles to create reliable CI/CD pipelines that work the same everywhere.

1

Create the basic Jenkins pipeline structure

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

Jenkins

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

Need a hint?

Start with pipeline {}, add agent any to run on any available node, and add stages {} for build steps.

2

Configure the Docker agent

Change the agent directive to use a Docker container with image alpine:latest. Use agent { docker { image 'alpine:latest' } }.

Jenkins

pipeline {
    agent {
        docker {
            image 'alpine:latest'
        }
    }
    stages {
        // Your code here
    }
}

Need a hint?

Use the agent block with docker and specify the image as 'alpine:latest'.

3

Add a stage to run a shell command inside the Docker container

Inside stages, add a stage named Run inside Docker. Inside it, add a steps block with a shell command echo "Hello from Docker" using sh.

Jenkins

pipeline {
    agent {
        docker {
            image 'alpine:latest'
        }
    }
    stages {
        stage('Run inside Docker') {
            steps {
                // Your code here
            }
        }
    }
}

Need a hint?

Use stage('Run inside Docker') with steps { sh 'echo "Hello from Docker"' } to run the command inside the container.

4

Print the output of the Docker container command

Add a script block inside steps to capture the output of echo "Hello from Docker" using sh(script: ..., returnStdout: true). Then print the output with echo.

Jenkins

pipeline {
    agent {
        docker {
            image 'alpine:latest'
        }
    }
    stages {
        stage('Run inside Docker') {
            steps {
                script {
                    // Your code here
                }
            }
        }
    }
}

Need a hint?

Use def output = sh(script: ..., returnStdout: true).trim() to get the command output, then print it with echo output.