Clean Checkout

Search
Searching TeamCity 4.x Documentation
Table of Contents

Clean Checkout (also referred to as "Clean Sources") is an operation that ensures that the next build will get a copy of the sources fetched all over from the VCS. All the content of the Build Checkout Directory is deleted and the sources are re-fetched from the version control.

Clean checkout is recommended if the directory content was modified by an external process via adding new or modifying, or deleting existing files.

You can invoke clean sources action for a build configuration from the Build Configuration page (see Actions drop-down in the top right corner), or for an agent from the Agent Details page. The action opens a list of agents/build configurations to clean sources for.

You can also enable automatic cleaning the project sources before every build, if you check the option Clean all files before build on the Create/Edit Build Configuration> General Settings page.

TeamCity maintains an internal cache for the sources to optimize communications with the VCS server. The caches are reset during the cleanup time. To resolve problems with sources update, the caches may need to be reset manually. To do this, just delete <TeamCity data directory>/system/caches directory.




See Also:

Labels