Build History Clean-Up Policy
Last modified: 20 April 2023Administration > 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 for various build configurations. The page also informs you about the next scheduled clean-up, and the duration of the last clean-up.
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. With the custom option selected, a user can specify either one or both following parameters:
More than ... days older that the last build — Specify the number of days to preserve the above selected data from the cleanup. 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.
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. |
Dependencies | Check the Prevent dependency artifacts cleanup option to keep artifacts of the build, if by the moment clean up starts there's at least one build depending on these artifacts. |
Save | Click this button to save changes and close the dialog. |
Thanks for your feedback!