Docker plugin for Jenkins
A Jenkins cloud plugin that dynamically provisions Docker containers as ephemeral build agents.
What is Docker plugin for Jenkins?
The Docker plugin for Jenkins is a Jenkins Cloud plugin that enables dynamic provisioning of Docker containers as Jenkins build agents. It automatically creates containers for individual builds, runs them, and cleans them up, providing scalable, isolated, and reproducible build environments without requiring Docker-specific configuration in the build jobs themselves.
Jenkins administrators and DevOps engineers who manage CI/CD infrastructure and need to provision isolated, ephemeral build agents using Docker containers.
Developers choose this plugin because it abstracts Docker complexity from Jenkins users, allowing builds to run in disposable containers without Docker expertise, while giving administrators fine-grained control over agent provisioning through template-based configuration and multiple launch methods.
Overview
Jenkins cloud plugin that uses Docker
Use Cases
Best For
- Dynamically provisioning isolated Docker containers as Jenkins agents for each build to ensure clean environments.
- Setting up scalable Jenkins build infrastructure using Docker hosts without installing a Docker client on Jenkins.
- Configuring Jenkins agents via YAML files using the Jenkins Configuration as Code plugin for infrastructure-as-code practices.
- Running Jenkins builds in custom Docker images with specific tooling installed without modifying job definitions.
- Managing multiple Docker hosts as Jenkins clouds for distributed containerized agent provisioning.
- Using SSH, JNLP, or attach methods to connect Docker container agents to Jenkins based on infrastructure requirements.
Not Ideal For
- Projects using Jenkins Pipeline with built-in docker steps (like docker.image or docker.withDockerRegistry)
- Teams requiring Docker Swarm integration for native container orchestration
- Simple Jenkins setups where static agents suffice and Docker overhead is unnecessary
- Environments with strict security policies that prohibit exposing Docker daemon over TCP
Pros & Cons
Pros
Automatically spins up Docker containers as Jenkins agents for each build, enabling scalable, on-demand resource allocation without manual configuration in jobs, as described in the dynamic agent provisioning feature.
Containers are created for a single build and removed afterward, ensuring clean, isolated environments that prevent contamination and enhance reproducibility, highlighted in the ephemeral containers approach.
Supports SSH, JNLP, and attach connections, allowing integration with various Docker images and network setups, with detailed prerequisites for each method in the README.
Integrates with Jenkins Configuration as Code plugin for YAML-based cloud definitions, enabling infrastructure-as-code practices with example configurations provided.
Cons
The plugin does not support Docker Engine Swarm mode API, as admitted in the README, limiting its use in clustered Docker environments that rely on native orchestration.
Requires configuring Docker hosts, opening TCP ports for remote connections if Jenkins is on a different OS, and setting up agent templates, which can be error-prone and time-consuming.
Multiple Docker-related plugins exist in Jenkins (e.g., docker-workflow), leading to user confusion and misreported bugs, as warned in the README's note section.
Frequently Asked Questions
Related Projects
droneHarness Open Source is an end-to-end developer platform with Source Control Management, CI/CD Pipelines, Hosted Developer Environments, and Artifact Registries.
DiunReceive notifications when an image is updated on a Docker registry
dockcheckCLI tool to automate docker image updates. Interactive or unattended with notifications, image backups, autoprune, no pre-pulling and more.
CyclonePowerful workflow engine and end-to-end pipeline solutions implemented with native Kubernetes resources. https://cyclone.dev
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.