Docker Runner

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

With Docker Runner, you can run builds and deployments in a Docker container to isolate the build process from the environment it runs in. This increases the security of your environments by providing more strict control over resources the continuous integration (CI) process has access to. The isolation also helps with the reliability of your CI by making sure that environment it runs in can be reliably recreated each time you run your builds.

If you want to user Docker images in your Bamboo builds, you can do that with Docker tasks. See Configuring the Docker task in Bamboo.

Before you begin

  • Make sure you have Docker installed. We advise to use the most recent version. Bamboo provides support for Docker for Mac, and Docker for Ubuntu in version 17 and later. 
  • Define a Docker capability in Bamboo. See Defining a new Docker capability

Enabling Docker Runner

Runner can be enabled for jobs and deployment environments when:

creating or editing deployment environments 

Enabling Docker for a job or a deployment environment disables their standard requirements which come from tasks and replaces them with a single requirement for Docker.

Custom requirements, manually configured by users, will not be erased, and will still be used for agent matching.

To enable Docker Runner, in the Isolate build section, just choose to run the job in a Docker container and provide the Docker image.  

When editing a job or a deployment environment, you can also specify which directories from Bamboo agent should be mounted as additional volumes to the Docker container.

Docker Runner is also fully supported with Bamboo Specs. See our Bamboo Specs reference guide.

Last modified on May 28, 2019

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.