A Bamboo Agent is a service that can run job builds. Each agent has a defined set of capabilities and can run builds only for jobs whose requirements match the agent's capabilities. To learn more about Bamboo, see: https://www.atlassian.com/software/bamboo

If you are looking for Bamboo Server Docker Image it can be found here.

Overview

This Docker image makes it easy to get an instance of Bamboo Agent up and running. This minimal image is suitable for customisation and contains only Bamboo Agent and OpenJDK 8.

Note that Bamboo Agent Docker Image does not include a Bamboo server.

Quick Start

For the agent’s home directory which is used for storing agent’s configuration and builds data, we strongly recommend mounting a host directory as a data volume or a named volume:

docker volume create --name bambooAgentVolume

Make sure your Bamboo server is running and has remote agents support enabled. To enable it:

Go to Administration > Agents.

Start the Bamboo Agent container:

 docker run -v bambooAgentVolume:/home/bamboo/bamboo-agent-home --name="bambooAgent" -d atlassian/bamboo-agent-base BAMBOO_SERVER_URL

where BAMBOO_SERVER_URL is the base URL of your Bamboo server.

Verify if your remote agent has registered itself. Go back to the Administration > Agents.

Security token

If you have security token verification enabled on your server, you can pass the token to the agent via the SECURITY_TOKEN environment variable in the docker run command.

JVM Configuration

You can pass additional JVM arguments by using the VM_OPTS environment variable.

This way you can customize the Bamboo agent’s memory usage by overriding the wrapper’s default configuration. For example, to change the initial memory to 512MB and the maximum memory to 2048MB, add the following properties to your docker run command:

-e VM_OPTS="-Dwrapper.java.initmemory=512 -Dwrapper.java.maxmemory=2048"

For the list of all configuration properties, see Wrapper configuration properties.

Extending base image

This Docker image contains only minimal setup to run a Bamboo agent which might not be sufficient to run your builds. If you need additional capabilities you can extend the image to suit your needs.

Example of extending the agent base image by Maven and Git:

FROM atlassian/bamboo-agent-base
USER root
RUN apt-get update && \
    apt-get install maven -y && \
    apt-get install git -y
    
USER ${BAMBOO_USER}
RUN ${BAMBOO_USER_HOME}/bamboo-update-capability.sh "system.builder.mvn3.Maven 3.3" /usr/share/maven
RUN ${BAMBOO_USER_HOME}/bamboo-update-capability.sh "system.git.executable" /usr/bin/git

Upgrade

Remote agents are updated automatically, so you don’t need to worry about it during Bamboo server upgrade. Agents automatically detect when a new version is available and downloads new classes from the server.

Issue tracker

You can view know issues here.
Please contact our support if you encounter any problems with this Dockerfile.

Support

For product support, go to support.atlassian.com

Change log

7.0

Base image changed to adoptopenjdk:8-jdk-hotspot-bionic
Improved image's layering

7.1.4

Added tini to act as the default PID 1 init process
Base image changed to adoptopenjdk:8-jdk-hotspot-focal

atlascommunity / docker-bamboo-agent-atlas-sdk