Managing cleanups

Cleanups are scheduled based on the cleanup policy. The cleanup policy contains settings that determine when build lives, build requests, and miscellaneous jobs are cleaned up.

About this task

Build life cleanup is determined by cleanup type and retention policy. Each build life is evaluated by its status. A build without a status is evaluated with the All Builds status. If the All Builds type has the Keep Days property or Keep Latest property set to Forever, no builds with this type are be cleaned up. A build life is not cleaned up if either the Keep Days or Keep Latest properties are met.

Procedure

Complete the following steps to schedule a cleanup.

  1. On the left navigational panel, click System > Cleanup.
  2. Click Edit.
  3. Select a schedule from the Schedule list.
    Schedules are defined on the Schedules page, see Creating schedules.
  4. Specify a number of days to keep lockable resources in the Days to Keep Lockable Resources field.
    This option applies to resources such as working directories. The default value is 30 days. Enter -1 to never clean up lockable resources.
  5. Specify the number of days to keep preflight builds in the Days to Keep Preflight Builds field.
    The default value is 30 days. Enter -1 to never clean up lockable resources.
  6. Click Save.
  7. Optional: Create additional cleanup policies.
    Click New to create a cleanup policy. See Adding and editing cleanup policy settings for details on cleanup policy settings.
  8. Click Done after you finish.