Bamboo Agent Docker Image with Docker in Docker (dind) Support

A customizable Bamboo agent Docker image with Docker in Docker support for your CI/CD workloads.

It is based on dcagatay/ubuntu-dind image.

Features

• Docker
• docker-compose
• s6-overlay

Quick Start

For a basic quick start;

• Set BAMBOO_SERVER_URL environment variable.
• Setup a volume mapping for container's /home/bamboo/bamboo-agent-home directory.
• Start the Docker container

For the initialization (authorization to Bamboo server), follow container logs for instructions of Bamboo agent.

docker run --privileged --rm -it -v "$PWD/data:/home/bamboo/bamboo-agent-home" -e "BAMBOO_SERVER_URL=http://bamboo-server.example.com:8065" dcagatay/bamboo-agent-base-dind:latest

You can also use docker-compose.yml or any other container environment in the same way.

Environment Variables

• BAMBOO_SERVER_URL: URL of the Bamboo Server instance. Required E.g. http://bamboo-server.example.com:8065.
• SECURITY_TOKEN: If you have enabled security token on Bamboo Server. Optional.
• DOCKER_EXTRA_OPTS: Arguments to dockerd command. Details can be found on its reference. Optional Default: --log-level=error --experimental

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.

Volumes

In order to persist Agent data, you should map /home/bamboo/bamboo-agent-home to local directory or Docker Volume.

Extending the Base Image

If you need additional capabilities you can extend the image to suit your needs.

Note that the image uses s6-overlay, please do your modifications according to standard s6-overlay usage. Do not overwrite ENTRYPOINT or CMD.

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

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

A complete example can be found in dcagatay/java-node-bamboo-agent Docker image.

Build variables

The image can be customized with the following build arguments.

• BAMBOO_AGENT_VERSION: Version of the agent.
• JAVA_11_DOWNLOAD_URL: Download URL for AdoptOpenJDK 11 that will run Bamboo agent. You can customize the version.
• BAMBOO_AGENT_DOWNLOAD_URL: Download URL of Bamboo agent. It is templated with BAMBOO_AGENT_VERSION. Modify the agent version instead.

Credits

• Atlassian's Bamboo agent base image docker-bamboo-agent-base.