This page last changed on Apr 07, 2008 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 (see 7.6 Enabling Expiry of Build Results). 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 (as described below). 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 delete 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 a plan's build results,
If you are creating a new plan, start at step 5.
- Click 'Home' to go to the Dashboard.
- Click the 'All Plans' tab.
- Locate the plan in the list and click this icon:

- The 'Configuration' tab will be displayed. Click the 'Post Actions' sub-tab.
- The 'Post Actions' tab will be displayed. Under 'Build Expiry', select 'Override global build expiry configuration'.
- 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, 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 7 above.
Note: builds can either be labelled:
- Click the 'Save' button if you are editing an existing plan; or if you are creating a new plan, either click the 'Next' button and go to 1.2.8 Specifying a Plan's Permissions or click the 'Summarise' button and go to 1.2.9 Completing and Enabling a New Plan (hidden).
Screenshot: 'Post Actions'

To disable expiry for a plan's build results data,
- Click 'Home' to go to the Dashboard.
- Click the 'All Plans' tab.
- Locate the plan in the list and click this icon:

- The 'Configuration' tab will be displayed. Click the 'Post Actions' sub-tab.
- The 'Post Actions' tab will be displayed. Under 'Build Expiry', deselect 'Override global build expiry configuration'.
- Click the 'Save' button.
|