This page last changed on Dec 13, 2007 by alui.
By enabling build expiry, you can choose how much build results data will be kept in your Bamboo system, and for how long it will be kept (e.g. for reporting purposes), before being automatically deleted.
If you disable build expiry, your build results will never be automatically deleted from Bamboo.
You can enable/disable build expiry for:
- all plans (as described below). This is generally the easiest way to manage your build expiry. Your settings will apply to all plans that do not have individual expiry settings.
- individual plans (see Specifying Expiry for a Plan's Build Results). You would generally only do this if there is a specific reason to keep/delete a particular plan's build results.
Note that you can also build results manually — see 1.4.1 Deleting a Build Result.
 |
If you enable build expiry, ensure that you back up your build results data before its expiry date is reached. |
To enable expiry for build results data,
- Click the 'Administration' link in the top navigation bar.
- Click the 'Build Expiry' link in the left navigation column.
- The 'Build Expiry' screen will be displayed. Click the 'Enable' button.
- The 'Build Expiry Settings' screen will be displayed (see screenshot below).
- In the 'What should be expired' section, select what type of build results data you want to delete:
- 'Artifacts' — select this if you want to delete all user-defined artifacts but keep all other build results data.
- 'Build results' — select this if you want to delete all build results data (including artifacts).
- Choose one of these three methods for specifying how much data to keep:
- To keep all build results up to a certain age,
Note: with this method, older plans could have all their build results deleted.
- In the 'Expiry period' field, specify the number of months/weeks/days for which you want to keep your build results, e.g. specify '24 months' to keep all build results for the last two years.
- In the 'Minimum builds to keep' field, specify '0'.
- To keep a certain number of build results per plan,
- In the 'Expiry period' field, specify '0'.
- In the 'Minimum builds to keep' field, specify the number of build results you want to keep, e.g. specify '50' to keep the latest 50 build results for each plan.
- To keep all build results up to a certain age, and a certain number of build results per plan,
- In the 'Expiry period' field, specify the number of months/weeks/days for which you want to keep your build results data, e.g. specify '24 months' to keep all build results for the last two years.
- In the 'Minimum builds to keep' field, specify the number of build results you want to keep, e.g. specify '50' to keep the latest 50 build results for each plan. (This means that, even if all of a plan's builds are over two years old, the last 50 build results will not be deleted.)
- In the 'Labels to keep' field, specify any labels for which you always want to keep labelled builds. (If you want to specify more than one label, use spaces to separate them.) For any label(s) that you specify, all builds that have a matching label will never be deleted, regardless of the method you followed in step 6 above.
Note: builds can either be labelled:
- Click the 'Save' button.
Screenshot: 'Enable Build Expiry'

To disable expiry for build results data,
- Click the 'Administration' link in the top navigation bar.
- Click the 'Build Expiry' link in the left navigation column.
- The 'Build Expiry' screen will be displayed (see screenshot below). Click the 'Disable' button.
Screenshot: 'Disable Build Expiry'

|