This is the documentation for Bamboo 5.5. View this page for the

Unknown macro: {spacejump}

of Bamboo, or visit the latest Bamboo documentation.

By enabling build expiry for just a plan (described below), you override the global expiry settings that affect all plans. If you disable build expiry for a plan, that plan's build result data will never be automatically deleted from your Bamboo server.

You can choose the build result data that will be kept for a plan and for how long this data will be kept (e.g. for reporting purposes), before Bamboo automatically deletes it.

You can also delete the results of a plan build manually — see Deleting the results of a plan build.

Configuring the expiry of build results for a plan

Before you begin:

  • Ensure that you back up your build results data before its expiry date is reached.

 

To enable and configure the expiry of build result data for a particular plan:

  1. Navigate to the configuration for the desired plan, as described on Editing a plan's configuration.
  2. Click Miscellaneous to display the plan's current build expiry settings.
  3. Select the Override global build expiry configuration check box. The following fields will be displayed:

    SettingResult
    Build resultsAll build results data (including artifacts and build logs) are deleted.
    ArtifactsOnly user-defined artifacts are deleted from the build results.
    Build logsOnly build logs are deleted from the build results.
    Expiry periodSpecifies the period (days, weeks or months) for which you want to keep build results.
    E.g. specify '24 months' to keep all build results for the last two years.
    Minimum builds to keepSpecifies the minimum number of build results you want to keep.
    E.g. specify '50' to keep the latest 50 build results, even if they are older than the period specified with Expiry period.
    Labels to keepSpecifies the build labels (not plan labels or job labels) applied to builds for which you want to keep build results, regardless of the Expiry period and Minimum builds to keep settings. Note that builds can be labelled either manually or automatically.
  4. Click Save.

(info) Note that the build expiry event is a global event that runs periodically, regardless of whether you disable or enable build expiry in your plans. When this event occurs, the build results for your plan will be expired according to the criteria specified in the settings above or globally. To configure the global event and global build expiry settings, please refer to Configuring global build results expiry.

Screenshot: Enabling Build Expiry


Disabling the expiry of build results for a plan

To disable expiry of the build result data for a particular plan:

  1. Navigate to the configuration for the desired plan, as described on Editing a plan's configuration.
  2. Click Miscellaneous.
  3. Select the Do not expire anything for this plan check box.
  4. Click Save.

Screenshot: Disabling Build Expiry