TeamCity 2019.2 Help

Copy, Move, Delete Build Configuration

To copy, move or delete a build configuration, use the Actions pop-up menu located in the upper right corner of the Build Configuration Settings. Alternatively, you can manage build configurations on the General Settings tab of the parent project's settings.

Copy and Move Build Configuration

Build configurations can be copied and moved to another project by project administrators:

  • A copy duplicates all the settings of the original build configuration, but no data related to builds is preserved. The copy is created with an empty build history and no statistics. You can copy a build configuration into the same or another project.

  • When moving a build configuration between projects, TeamCity preserves its settings and associated data as well as its build history and dependencies.

On copying, TeamCity automatically assigns a new ID to the copy. It is also possible to change the ID manually. Select the Copy associated user, agent and other settings option to ensure that all the settings, such as notification rules or agent's compatibility, are exactly the same for the copied and original build configurations for all the users and agents affected.

If the build configuration uses VCS roots or is associated with a template which is not accessible in the target project (does not belong to the target project or one of its parent projects), the copies of these VCS roots and the template will be created in the target project (also see the related issue TW-28550).

Delete Build Configuration

When you delete a build configuration, TeamCity will remove its .xml configuration file. After the deletion, there is a configurable timeout (5 days by default) before the builds of the deleted configuration are removed during the build history clean-up.

If you attempt to delete a build configuration which has dependent build configurations, TeamCity will warn you about it. If you proceed with deletion, the dependencies will no longer function.