Build History Clean-Up Policy

TeamCity 4.0 is not yet released and is actively developed. You can try it within our Early Access Program. Released verisons documentation.
Documentation Index

Administration > Configure clean-up policy

On this page you can enable or disable the clean-up process, set up its timing, and configure the clean-up policy for various build configurations. The page also informs you about the next scheduled clean-up, and the duration of the last clean-up.

In this section:

Clean-up Process Settings

Option Description
Enable/Disable If the clean-up policy is disabled, the page is blank, and Enable button is available. If clean-up policy is enabled, this page displays the list of build configurations that have a clean-up policy.
Clean-up process settings Use the following fields to create the clean-up schedule.
Clean-up process start time Use the drop-down list to select the start time using the hh:mm format.
Save Click this button to save the start time settings.
The next clean-up is scheduled for This field shows the scheduled time for the next clean-up process start.
Last time clean-up took This field shows duration of the last cleanup process.
Start clean-up now Click to launch clean-up immediately.

Configure Clean-up Rules for Specific Build Configurations

TeamCity fetches information on all projects and build configurations which are set up in your company, and you can use the table to view which data are cleaned and edit the default and specific clean-up rules. The grey text in the What to clean column shows the build configuration has a default clean-up rule. Click the text to modify the clean-up policy of the desired build configuration.

Edit Clean-Up Rule Dialog

Select either a default or custom option to turn on the default clean up rule or create a specific rule.

Option Description
Clean artifacts (and keep history and statistical data) Select this option to remove only artifacts from the build history.
Clean history (and keep statistical data) Select this option to remove the builds (including artifacts) but retain statistical information.
Clean everything (including statistical data, history, and artifacts) Select this option to remove everything from the build history.
More than ... days older that the last build Check this option to preserve the above selected data for a duration of time; select this option and specify the number of days. A day is equivalent to a 24-hour period, not a calendar day.
Older than the ...-th successful build Check this option to preserve a certain amount of successful builds (and all the failed builds between them); specify the number of successful builds to be kept.
Save Click this button to save changes and close the dialog.

See Also:

Labels