Adding and editing cleanup policy settings

Use the cleanup settings to determine when build lives, build requests, and miscellaneous jobs are cleaned up.

You can define multiple cleanup policies and modify the default policy. The list of policies is displayed on the Cleanup window. Policies that you create can be deleted using the delete icon. The default policy can be disabled.

  1. On the left navigational panel, click System > Cleanup.
  2. Click New to add a policy. To modify a cleanup policy, click the policy name.
    If you are creating a new policy, complete the Name and policy settings are displayed.
  3. To modify a build cleanup settings, click the edit icon in the Cleanup Build area.
    1. Specify the number of days to keep build lives in the Keep Days field.
      Leave the field blank to keep builds forever.
    2. Specify the number build lives to keep regardless of other cleanup settings in the Keep Latest field.
      The number of build lives that are kept indefinitely is equal to the number you specify.
    3. Select the cleanup type from the Cleanup Type list.
      The cleanup type determines what happens to build lives with a certain status when a cleanup is scheduled:
      • Delete deletes the build life, artifacts, and logs from the server.
      • Deactivate and Delete Logs deletes the build artifacts and logs and sets the build to inactive status. This option prevents running processes on the build life and prevents the use to satisfy dependencies.
      • Deactivate deletes the build life artifacts and sets the build life to inactive status. This option prevents process runs and prevents the use of the build life to satisfy dependencies.
      • Archive deletes the build life artifacts and sets the build life to archived status. The build life can be unarchived and its artifacts rebuilt with an unarchive process. No secondary processes can run on this build and it cannot be used to satisfy dependencies.
    4. Click Save.
  4. To modify a build request cleanup settings, click the edit icon in the Cleanup Build Requests area.
    1. Specify the number of days to keep miscellaneous jobs in the Misc Jobs field.
      Miscellaneous jobs refer to cleanups and notifications among others. These jobs and their logs can be deleted from the server by specifying a number to keep. Leave the field blank to keep them forever.
    2. Specify the number of days to keep build requests without builds in the Build Requests Without Build field.
      These build requests did not produce builds. Leave the field blank to keep requests forever.
    3. Click Save.
  5. Click the Dependencies tab, and then specify projects that depend on the policy.
  6. Click the Main tab and then click Done.