Build Checkout Directory

Skip to end of metadata
Go to start of metadata
You are viewing documentation of TeamCity 4.x, which is not the most recent released version of TeamCity. Please refer to the listing to choose another version.
Search

Searching TeamCity 4.x Documentation

Table of Contents

The build checkout directory is the directory where all of the project's sources reside. If the VCS checkout mode property of the build configuration is set to Automatically on server or Automatically on agent, TeamCity places the sources into the checkout directory according to the mapping defined in the VCS Checkout Rules.

If not specified, automatically created directory is used with a generated name: <Agent Working Directory>/<VCS settings hash code>. The VCS settings hash code is calculated based on VCS roots and VCS settings used by the build configuration. Effectively, this means that the directory is shared between all the build configurations with the same VCS settings.

If you need to know the directory used by a build configuration, you can refer to <Agent Working Directory>/directory.map generated file which lists build configurations with the directory used by them.

If for some reason default directory does not match your requirements (for example, the process of creating builds depends on some particular directory), you may want to specify your own build checkout directory.

Please ensure that the checkout directory is not shared between build configurations with different VCS settings. Please also ensure that the content of the directory is not modified by other processes.
Otherwise, the directory content may get out of sync with the state TeamCity think it is in and the files may not be updated to the state necessary for a build. In this case Clean Checkout will be necessary.

As a kind of failover measure TeamCity automatically performs Clean Checkout, if it finds files of another build configuration in the current checkout directory or the directory is empty.

In your build script you may refer to the effective value of build checkout directory via the teamcity.build.checkoutDir property provided by TeamCity.

Automatic Checkout Directory Cleaning

Checkout directories are automatically deleted from disk if not used (no builds use it as checkout directory) for a specified period of time (8 days by default). This behavior only applies to default checkout directories (explicitly specified checkout directories are not cleaned).

The time frame can be changed by specifying new value (in hours) by either of the following ways:

Setting the property to "0" will cause deleting the checkout directories right after the build finish.

Cleaning Directory in Background

When a build's sources are checked out to a Build Checkout Directory on a build agent and before the build is started to run, TeamCity checks the available free space. By default, the required free space is 3Gb.
You can specify the free space value for a build agent in its buildagent.properties file or change the default value for a particular build configuration by specifying its system properties.

Required free space value is defined by the following properties:

  • Set teamcity.agent.ensure.free.space with bytes to ensure space under build configuration folder.
  • Set teamcity.agent.ensure.free.temp.space with bytes to ensure space under 'temp' folder. If teamcity.agent.ensure.free.temp.space is not defined, the value of teamcity.agent.ensure.free.space property will be used.

TeamCity checks the values in the following order:

  • build configuration system property
  • buildAgent.properties file property
  • if no specified property values found, then TeamCity uses the default value — 3Gb.

Generally, the teamcity.agent.ensure.free.space property value is set in bytes. Also, you can specify the value in kb, mb, gb, kib, mib, or gib.

If build agent does not have required free space under temp or build checkout folders, .old directories cleanup is started.



See Also:

Labels:

build build Delete
directory directory Delete
checkout checkout Delete
Enter labels to add to this page:
Wait Image 
Looking for a label? Just start typing.