See also

 Indore 2017.2 EAP1 (build 49391) Release Notes

Indore 2017.2 EAP2 (build 49708) Release Notes


Server Auto Upgrade

Upgrading a TeamCity server is much simpler now. When a new version of TeamCity is detected, the server displays the corresponding health item for system administrators. This health item points to a new Update page in the server administration area, where all the upgrade options are listed. On this page there are notes about licenses compatibility, the new version description and controls to perform auto-upgrade.


If you’re running the previous TeamCity EAP, check the Administration | Update page. Upgrade to the new EAP build should be as easy as a click on an Update button.


Screen Shot 2017-09-19 at 20.16.43.png


Current limitations (some of them will be addressed in future releases):

Kotlin DSL Improvements 

In recent versions of TeamCity, when Kotlin DSL is enabled for a project, the administration part of the TeamCity user interface used to be read-only. Which is fine if you’re familiar with Kotlin DSL, but not very user-friendly if you’ve just started working with Kotlin projects.

But we’re glad to announce that starting with this EAP when you switch a project to Kotlin DSL, project and build configuration settings will be available for editing from the web UI. All changes made in a project via the web user interface will be presented as a patch in the Kotlin format which will be checked in under the project “patches” directory. Moreover, if after switching to the Kotlin DSL you did not change the generated DSL files, UI changes will be applied in place, no patch will be generated at all. So if you ever had an interest in Kotlin DSL, but thought that sacrificing the user interface was too high a price for it, starting with this EAP this is no longer the case.

Note that TeamCity does not enable editing of the project right after the switch to Kotlin format. TeamCity needs to detect its own commit in the repository, and only after that editing will be enabled. Usually it takes a minute or two.

Web UI editing for existing Kotlin DSL projects

If you already have a project in Kotlin, then for web UI editing to be enabled for your project, the project should start using v2017_2 API of the Kotlin DSL. For this, your .kt files should be switched to packages from v2017_2 version. To compile this project, you also need to update your pom.xml with the following:


Alternatively, you can invoke the ‘Download settings in Kotlin format’ action in your project and copy the pom.xml from the generated zip archive.

Once you switch the project to new API and check in the changes, TeamCity will detect and apply them and after that web UI editing will be enabled.

Notes on patches

When settings are edited in the UI, TeamCity generates a patch script in a dedicated package ‘<project external id>.patches.(buildTypes|templates|vcsRoots|projects)’, script name is <uuid of the entity>.kts. The patch script is executed after regular dsl scripts and applies the UI changes to the generated settings if the settings are in the expected state. For example, if you change the build configuration name, then the patch scripts checks that the name produced by the regular script isn’t changed and then updates the name. Once the patch script is committed to the settings repository, you can apply its changes to your settings. After that, the patch script should be removed.


Some of the UI actions will still be disabled for projects in Kotlin:
external id change (for all entities - project, build configuration, template or VCS root)
move actions
editing of the versioned settings VCS root
versioned Settings configuration change in a project

Other improvements
The pom.xml file provided for a Kotlin project has the 'generate' task, which can be used to generate TeamCity XML files locally from the Kotlin DSL files. This task now supports debugging. If you’re using IntelliJ IDEA, you can easily start debugging of a Maven task, see screenshot: <TODO>

Kotlin DSL documentation is now generated in the background reducing the server startup time

Composite Builds Improvements

Exclude rules and different target paths are not supported yet, but we are planning  to add support for them in the next EAP build.

Perforce Stream Depth Support

Previously the Perforce VCS Roots in TeamCity only supported streams stored one level below the depot name, i.e. the default stream depth of 1: //myStreamDepot/myStream1). Starting from this EAP, TeamCity supports deeper directory structure within the root depot: depots with a depth of //DEPOTNAME/1/2/n can be specified in the Perforce "Stream" field.
See the related request in our tracker.

Docker Support Improvements

Cloud Agents

Other Improvements