Every build that is executed within Continua CI stores information in the server's workspace, such as artifacts and build logs. These by-products are vital for executing your build process and tracking build information, however they can also take up considerable disk space over time. Cleanup policies provide a way to remove any unneeded or old build data, which reduces the amount of disk space that Continua is currently using.

Overriding Cleanup Policies

Cleanup policies can be defined at all three levels of Continua CI, which are the global, project and configuration level. By default, the global cleanup policy is applied to every configuration in Continua CI, however these can be overridden on either the project or configuration. If a project defines a cleanup policy then every configuration that belongs in that project will automatically inherit the project's cleanup policy rather than the global policy. 

By default, the global policy will be applied to all builds, however you can override this at either the project or configuration level. Each cleanup policy runs once per day. You can choose when it runs and control which builds and by-products are cleaned up.

Note that build cleanup is permanent: a cleaned up build cannot be recovered.

How to Define Cleanup Policies

Cleanup policies are defined in following areas of Continua.

Global Cleanup Policy

The global policy can be found in the administration section, under the Continuous Integration (CI) Settings.

Project Cleanup Policy

A project's cleanup policy can be defined in it's project wizard. The project wizard can be found by selecting a project and clicking 'Edit Project' in the Tasks menu. The cleanup policy is the last page in the project wizard.

Configuration Cleanup Policy

A configuration's cleanup policy is defined in it's configuration wizard. It can be found by editing the configuration and navigating to the cleanup section of the wizard.

Cleanup Policy Options

Run Cleanup Task Daily at

Specify when the cleanup should execute each day.

Build Age

All builds that are older than the build age will be removed when the cleanup runs. 

Minimum Builds

This specifies the minimum number of builds that should be kept at all times, regardless of build age.

Maximum Builds

This specifies the maximum number of builds that should be kept at any one time, regardless of build age. If the number of existing builds is greater than this number then the oldest builds will be deleted.

What to Cleanup

All: This will delete all artifacts, logs and database entries.

Artifacts: This will delete all artifacts in the build's workspace from physical memory. Once artifacts have been deleted, they are no longer accessible through the build's artifacts page.

Logs: This will delete all build logs in the build's workspace from physical memory. Once logs have been deleted, they are no longer accessible through the build's log page.

Database: The build is deleted from the Continua database which removes all references to it from Continua. Deleted builds will no longer appear on the history or activity pages, nor will they contribute to the configuration's statistics and metrics.

Saving the Policy

Save: Saves the cleanup policy and the cleanup will run at the time specified.

Save and Run Now: Saves the cleanup policy and runs the cleanup immediately.