Changing storage paths for builds and artifacts in Bamboo
Purpose
Bamboo stores artifacts, build working and project directories in the home directory. There are some instances where users will be interested in having this stored outside of Bamboo or even in a network to preserve space on the build machine.
Solution
All paths can be configured in the bamboo-cfg.xml
located in the home directory. The three relevant properties and their default values have been included below:
<property name="bamboo.artifacts.directory">${bambooHome}/artifacts</property>
<property name="bamboo.project.directory">${bambooHome}/xml-data/builds</property>
<property name="buildWorkingDir">${bambooHome}/xml-data/build-dir</property>
If you wish to change the location where Bamboo stores its backup, please see the below documentation under Backup Path section for the relevant information:
Example steps for configuring the location where artifacts are stored:
Please note, once the below path is changed any existing artifacts will no longer be accessible to builds and deployments unless they are migrated to the new location. We recommend testing and planning for an artifact migration, as permission issues (especially on Windows network shares) could cause Bamboo to be unable to access artifacts under the new location.
Navigate to the
bamboo-cfg.xml
file in the home directory and change the location as desired. For example to change the artifacts location to a network share, E.g.\\10.60.1.246\ATL04\artifacts
, the file content should be changed from:<property name="bamboo.artifacts.directory">${bambooHome}/artifacts</property>
to
<property name="bamboo.artifacts.directory">\\10.60.1.246\ATL04\artifacts</property>
- Restart Bamboo.