Types of Agents

Agents extend the Jenkins controller by running executors on remote nodes. In your Jenkinsfile, you declare the agent block to control where and how each pipeline stage executes. Agents handle the communication protocol, authentication, and tool resolution required for build and test jobs.

Controller-Worker Architecture

Jenkins controllers delegate work to agents over SSH or JNLP. All required build tools must be installed on the agent node.

The image illustrates the Jenkins architecture, showing the relationship between the Jenkins Controller Node and Jenkins Worker Nodes (Linux and Windows) using SSH and JNLP connections.

Static vs. Containerized Agents

Besides static (permanent) agents, you can leverage Docker or Kubernetes to provision agents on demand. Container-based agents launch a clean environment each build, ensuring consistency and eliminating dependency conflicts.

The image describes aspects of Jenkins architecture, highlighting the use of Docker containers for build agents, ideal builds with specific dependencies, and ensuring isolated environments.

Common Agent Types

Below is a quick reference of the most widely used Jenkins agent types:

Agent Type	Description	Use Case
Permanent Agents	Dedicated nodes with pre-installed tools (e.g., JDK, Node.js)	Stable, consistent environments
Docker Agents	Ephemeral containers spun up per build with required dependencies	Isolation, reproducibility
Cloud-Based Agents	On-demand VMs or pods in cloud providers (AWS, Azure, Kubernetes)	Elastic scaling, pay-per-use
Label-Based Agents	Nodes tagged by labels to match specific pipeline requirements	Decoupling builds from physical topology

Permanent agents remain online even when idle, consuming resources. Consider ephemeral Docker or cloud agents for variable workloads.

The image lists four types of agents: Permanent Agents, Docker Agents, Cloud-Based Agents, and Label-Based Agents, each with a corresponding icon.

Agent Declarations in a Jenkinsfile

Use the declarative pipeline syntax to specify where your pipeline runs:

1. agent any

Runs the entire pipeline on any available agent.

pipeline {
    agent any
    stages {
        stage('Build') {
            steps {
                sh 'echo Running on ${NODE_NAME}'
            }
        }
    }
}

2. Label-Based Agent

Targets a node with a specific label. Ensure a node labeled my-agent exists.

pipeline {
    agent { label 'my-agent' }
    stages {
        stage('Build') {
            steps {
                sh 'echo Running on ${NODE_NAME}'
            }
        }
    }
}

3. Docker Agent

Spins up a Docker container using the specified image and arguments.

Ensure Docker is installed and the Jenkins user has permissions to run containers on this agent.

pipeline {
    agent {
        docker {
            image 'node:latest'               // Node.js image
            args  '-v $HOME/.npm:/root/.npm'  // Mount NPM cache
        }
    }
    stages {
        stage('Build') {
            steps {
                sh 'npm install'
                sh 'npm test'
            }
        }
    }
}

4. Default and Stage-Level Agents

Defines a global agent and overrides it for specific stages.

pipeline {
    agent { label 'my-agent' } // Default for all stages
    stages {
        stage('Build') {
            agent { label 'nodejs-agent' } // Stage-specific agent
            steps {
                sh 'echo Running on ${NODE_NAME}'
            }
        }
        stage('Test') {
            steps {
                sh 'echo Tests running on default agent'
            }
        }
    }
}

This approach lets you mix general-purpose agents with specialized environments for individual stages.

Introduction and Basics

Jenkins Setup and Interface

Extending Jenkins and Administration

Jenkins Pipelines

Automation and Security

Setting up CI Pipeline

Code Quality and Testing

Containerization and Deployment

Kubernetes and GitOps

AWS Lambda and Advanced Deployment Techniques

Jenkins Administration and Monitoring - Part 1

Shared Libraries in Jenkins

Agents and Nodes in Jenkins

Pipeline Enhancement and Caching

Pipeline Structure and Scripted vs Declarative

Jenkins Administration and Monitoring - Part 2

Backup and Configuration Management

Controller-Worker Architecture

Static vs. Containerized Agents

Common Agent Types

Agent Declarations in a Jenkinsfile

1. agent any

2. Label-Based Agent

3. Docker Agent

4. Default and Stage-Level Agents

Links and References

Watch Video

​Controller-Worker Architecture

​Static vs. Containerized Agents

​Common Agent Types

​Agent Declarations in a Jenkinsfile

​1. agent any

​2. Label-Based Agent

​3. Docker Agent

​4. Default and Stage-Level Agents

​Links and References

Watch Video

Controller-Worker Architecture

Static vs. Containerized Agents

Common Agent Types

Agent Declarations in a Jenkinsfile

1. agent any

2. Label-Based Agent

3. Docker Agent

4. Default and Stage-Level Agents

Links and References