progressoft/bamboo repository overview

For the BAMBOO_HOME directory that is used to store, among other things, the configuration data we recommend mounting a host directory as a data volume, or using a named volume.

Volume permission is managed by entry scripts. To get started you can use a data volume, or named volumes. In this example we'll use named volumes.

 docker volume create --name bambooVolume
 docker run -v bambooVolume:/var/atlassian/application-data/bamboo --name="bamboo" --init -d -p 54663:54663 -p 8085:8085 progressoft/bamboo:6.3.2

Note that this command can be replaced by named volumes.

Start Atlassian Bamboo:

docker run -v /data/bamboo:/var/atlassian/application-data/bamboo --name="bamboo-server"  --init -d -p 54663:54663 -p 8085:8085 progressoft/bamboo:6.3.2

Success. Bamboo is now available on http://localhost:8085⁠*.

Note that the --init flag is required to properly reap zombie processes.

Make sure your container has the necessary resources allocated to it. We recommend 2GiB of memory allocated to accommodate the application server. See Supported Platforms for further information.

JVM Configuration If you need to override Bamboo's default memory configuration or pass additional JVM arguments, use the environment variables below

JVM_MINIMUM_MEMORY (default: 512m)

The minimum heap size of the JVM

JVM_MAXIMUM_MEMORY (default: 1024m)

The maximum heap size of the JVM

JVM_SUPPORT_RECOMMENDED_ARGS (default: NONE)

Additional JVM arguments for Bamboo, such as a custom Java Trust Store

Upgrade To upgrade to a more recent version of Bamboo you can simply stop the bamboo container and start a new one based on a more recent image:

 docker stop bamboo
 docker rm bamboo
 docker pull atlassian/bamboo-server:<desired_version>

docker run ... (See above)

As your data is stored in the data volume directory on the host it will still be available after the upgrade.

Note: Please make sure that you don't accidentally remove the bamboo container and its volumes using the -v option.

Backup For evaluations you can use the built-in database that will store its files in the Bamboo home directory. In that case it is sufficient to create a backup archive of the directory on the host that is used as a volume (/data/bamboo in the example above).

Versioning The latest tag matches the most recent version of this repository. Thus using atlassian/bamboo-server:latest or atlassian/bamboo-server will ensure you are running the most up to date version of this image.

However, we ** strongly recommend ** that for non-eval workloads you select a specific version in order to prevent breaking changes from impacting your setup. You can use a specific minor version of Bamboo by using a version number tag: atlassian/bamboo-server:6.7. This will install the latest 6.7.x stable version that is available.

Running Bamboo Server with a Remote Agent If you want to run Bamboo Server and Agent containers on one host (in one Docker engine), you will need to create a Docker network for them:

docker network create bamboo

You can start Bamboo Server and Agent using following commands:

docker run -v bambooVolume:/var/atlassian/application-data/bamboo --name bamboo-server --network bamboo --hostname bamboo-server --init -d -p 8085:8085 progressoft/bamboo:6.3.2
 docker run -v bambooAgentVolume:/home/bamboo/bamboo-agent-home --name bamboo-agent --network bamboo --hostname bamboo-agent --init -d atlassian/bamboo-agent-base http://bamboo-server:8085