Docker socket mounting in Jenkins - Mini Project: Build & Apply

Docker Socket Mounting in Jenkins

📖 Scenario: You are setting up a Jenkins pipeline that needs to build Docker images. To do this, Jenkins must access the Docker daemon on the host machine. This is done by mounting the Docker socket inside the Jenkins container.This project will guide you step-by-step to configure the Docker socket mounting in a Jenkins pipeline script.

🎯 Goal: Build a Jenkins pipeline script that mounts the Docker socket /var/run/docker.sock from the host into the Jenkins container, allowing Docker commands to run inside the pipeline.

📋 What You'll Learn

Create a Jenkins pipeline script with a Docker agent

Mount the Docker socket /var/run/docker.sock inside the container

Use the mounted socket to run a Docker command inside the pipeline

Print the output of the Docker command

💡 Why This Matters

🌍 Real World

Mounting the Docker socket allows Jenkins pipelines to build, run, and manage Docker containers on the host machine. This is common in CI/CD pipelines for containerized applications.

💼 Career

Understanding Docker socket mounting is essential for DevOps engineers and Jenkins administrators who automate Docker workflows and container deployments.

1

Create Jenkins pipeline with Docker agent

Write a Jenkins pipeline script that uses a docker agent with the image docker:latest. Create a pipeline block with an agent section specifying docker { image 'docker:latest' }.

Jenkins

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

Hint

Use the docker agent block inside agent to specify the Docker image.

2

Mount Docker socket inside the Docker agent

Add a args option inside the docker agent block to mount the Docker socket. Use args '-v /var/run/docker.sock:/var/run/docker.sock' to mount the socket from the host to the container.

Jenkins

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

Hint

The args option lets you pass extra Docker run arguments like volume mounts.

3

Add a stage to run a Docker command

Inside the stages block, add a stage named 'Check Docker'. In the steps section of this stage, run the shell command docker ps to list running Docker containers.

Jenkins

pipeline {
    agent {
        docker {
            image 'docker:latest'
            args '-v /var/run/docker.sock:/var/run/docker.sock'
        }
    }
    stages {
        // Your code here
    }
}

Hint

Use stage and steps blocks to organize pipeline tasks. Use sh to run shell commands.

4

Print the output of the Docker command

Modify the sh step to capture the output of docker ps into a variable called dockerOutput. Then add a echo step to print dockerOutput.

Jenkins

pipeline {
    agent {
        docker {
            image 'docker:latest'
            args '-v /var/run/docker.sock:/var/run/docker.sock'
        }
    }
    stages {
        stage('Check Docker') {
            steps {
                // Your code here
            }
        }
    }
}

Hint

Use sh with returnStdout: true to capture command output. Use echo to print it.

Practice

1. What is the main purpose of mounting the Docker socket /var/run/docker.sock inside a Jenkins container?

easy

A. To allow Jenkins to control Docker on the host machine

B. To increase Jenkins container storage space

C. To isolate Jenkins from the host Docker engine

D. To enable Jenkins to run without Docker installed

Solution

1. Step 1: Understand Docker socket mounting

   Mounting /var/run/docker.sock lets a container communicate with the host's Docker engine directly.

2. Step 2: Apply to Jenkins use case

   Jenkins uses this to build and run Docker containers on the host from inside its own container.

3. Final Answer:

   To allow Jenkins to control Docker on the host machine -> Option A

4. Quick Check:

   Docker socket mounting = Jenkins controls host Docker [OK]

Hint: Docker socket mounting = container controls host Docker [OK]

Common Mistakes:

• Thinking it increases container storage
• Assuming it isolates Jenkins from Docker
• Believing it removes need for Docker installation

2. Which of the following is the correct Docker run command snippet to mount the Docker socket inside a Jenkins container?

easy

A. docker run -v /var/run/docker.sock:/var/run/docker jenkins

B. docker run -v /var/run/docker.sock:/docker.sock jenkins

C. docker run -v /docker.sock:/var/run/docker.sock jenkins

D. docker run -v /var/run/docker.sock:/var/run/docker.sock jenkins

Solution

1. Step 1: Identify correct volume mount syntax

   The syntax is -v host_path:container_path. The Docker socket is at /var/run/docker.sock on the host and must be mounted to the same path inside the container.

2. Step 2: Match correct paths

   docker run -v /var/run/docker.sock:/var/run/docker.sock jenkins correctly mounts /var/run/docker.sock from host to container at the same path.

3. Final Answer:

   docker run -v /var/run/docker.sock:/var/run/docker.sock jenkins -> Option D

4. Quick Check:

   Correct volume mount syntax = docker run -v /var/run/docker.sock:/var/run/docker.sock jenkins [OK]

Hint: Mount socket with same host and container path [OK]

Common Mistakes:

• Swapping host and container paths
• Using incorrect socket path inside container
• Missing /var/run prefix

3. Given this Jenkins Docker run command:

docker run -d -v /var/run/docker.sock:/var/run/docker.sock jenkins

What will happen if Jenkins tries to run docker ps inside its container?

medium

A. It will show an error: Docker command not found

B. It will list running Docker containers on the host

C. It will list containers inside the Jenkins container only

D. It will fail because Docker daemon is not running inside Jenkins

Solution

1. Step 1: Understand socket mount effect

   Mounting the Docker socket lets Jenkins use the host's Docker daemon, so commands like docker ps run inside Jenkins actually query the host Docker.

2. Step 2: Predict command output

   Therefore, docker ps inside Jenkins will list containers running on the host, not inside Jenkins container.

3. Final Answer:

   It will list running Docker containers on the host -> Option B

4. Quick Check:

   Docker socket mount = host Docker commands inside container [OK]

Hint: Docker socket mount = host Docker commands work inside container [OK]

Common Mistakes:

• Thinking Docker runs inside Jenkins container
• Assuming Docker command is missing
• Confusing container vs host Docker context

4. You mounted the Docker socket in Jenkins container but get permission denied errors when running Docker commands inside Jenkins. What is the likely cause?

medium

A. Jenkins user inside container lacks permission to access the socket

B. Docker daemon is not installed on the host

C. The socket path inside container is incorrect

D. Jenkins container network is disconnected

Solution

1. Step 1: Analyze permission error cause

   The Docker socket file on the host has restricted permissions. If Jenkins runs as a user without access rights, it will get permission denied.

2. Step 2: Confirm other options

   Docker daemon must be running on host (else other errors). Socket path is correct if mounted. Network issues don't cause permission denied on socket.

3. Final Answer:

   Jenkins user inside container lacks permission to access the socket -> Option A

4. Quick Check:

   Permission denied = user lacks socket access [OK]

Hint: Check Jenkins user permissions on Docker socket [OK]

Common Mistakes:

• Blaming Docker daemon absence
• Assuming wrong socket path
• Confusing network issues with permissions

5. You want Jenkins to build Docker images inside its container using the host Docker engine. Which combination of steps is the safest and most effective approach?

hard

A. Mount /var/run/docker.sock and run Jenkins as root user inside container

B. Install Docker daemon inside Jenkins container and do not mount socket

C. Mount /var/run/docker.sock and add Jenkins user to Docker group on host and container

D. Use Docker-in-Docker (DinD) without mounting socket

Solution

1. Step 1: Understand mounting socket and permissions

   Mounting the Docker socket allows Jenkins to use host Docker. Running as root is risky and not recommended.

2. Step 2: Apply best practice for permissions

   Adding Jenkins user to Docker group on host and container grants needed permissions safely without root.

3. Step 3: Evaluate alternatives

   Installing Docker daemon inside Jenkins container duplicates effort and complicates setup. DinD is more complex and less secure.

4. Final Answer:

   Mount /var/run/docker.sock and add Jenkins user to Docker group on host and container -> Option C

5. Quick Check:

   Socket mount + Docker group permissions = safe Jenkins Docker use [OK]

Hint: Use socket mount + Docker group permissions, avoid root [OK]

Common Mistakes:

• Running Jenkins as root inside container
• Installing Docker daemon inside Jenkins container
• Using DinD without understanding risks