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

Unknown macro: {spacejump}

of Bamboo, or visit the latest Bamboo documentation.

Global build expiry allows you to choose when build result data and artifacts will be deleted from your Bamboo system.

Build result data is used for such things as reporting. If global build expiry is disabled, the build result data for your plans will never be deleted from your Bamboo server. This could lead to a large portion of your Bamboo server's storage space being used to store this data.

You can configure build results expiry for:

  • all plans (i.e. 'global', described below). This is generally the easiest way to manage build expiry in Bamboo. The global configuration applies to all plans that do not override the global build expiry settings.
  • individual plans (see Configuring build results expiry for a plan). You would generally only do this if there is a specific reason to keep/delete a particular plan's build result data.

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

You must be Bamboo administrator to configure global build results expiry.

On this page:

Related pages:

Atlassian Blogs:

Configuring global expiry

Before you begin:

  • If you enable build expiry, ensure that you back up your build results data before its expiry date is reached.

To enable and configure global expiry of build result data:

  1. Click the  icon and select Overview.
  2. Click Build Expiry (under 'Plans') in the left-hand panel.
  3. Click Edit.
  4. Click the icon on the right of the scheduled expiry to set when the build expiry event will be triggered. You can specify a cron expression if required. See this FAQ for help constructing cron expressions.
  5. Clear the Disable Global Build Expiry checkbox, if necessary, to enable build expiry. The controls described below 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.
  6. Click Save.

(info) Note that the Disable Global Build Expiry checkbox, described above, only controls the deletion of build results. The build expiry event (triggered by the expiry Schedule) will still run. For example, you may wish to disable build expiry globally, but still schedule a global build expiry event that triggers the deletion of build data from individual plans. See Configuring build results expiry for a plan for details on how to override the global build expiry settings.

Disabling global expiry

To disable global expiry of build result data:

  1. Click the  icon and select Overview.
  2. Click Build Expiry (under 'Plans') in the left-hand panel.
  3. Click Edit, then check Disable Global Build Expiry.

Screenshot: Configuring build expiry


 

 

 

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.