Child pages
  • Indore 10 EAP2 (build 41463) Release Notes
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 20 Next »

DSL for TeamCity project configuration

Up until this EAP there were three options how project settings could be configured in TeamCity. The straightforward way - via the web UI, using REST API, or via XML files if versioned settings feature is enabled.

In this EAP we introduce another way - ability to define settings programmatically with help of DSL based on Kotlin language.

Kotlin based DSL can be seen as an evolution of the versioned settings, with it you can define your configuration in Kotlin language, without the need to use XML files.

Since Kotlin is statically typed, you automatically receive auto-completion feature in IntelliJ IDEA which makes discovery of available API options a much simpler task.

To get started with Kotlin DSL navigate to Versioned settings menu option for your project and choose kotlin as settings format:


After that TeamCity will generate necessary Kotlin files for this project and check-in them into the specified repository under .teamcity directory. If this repository already had project settings in XML format, they will be preserved.

TeamCity also adds pom.xml file under .teamcity directory. You can open this POM in your IntelliJ IDEA and start working with Kotlin DSL right away. All necessary dependencies will be resolved automatically.

Some important facts:

  • each time when you make a commit into .teamcity, TeamCity will execute Kotlin DSL files. Since internally, TeamCity still operates with XML, executed DSL files will produce a bunch of XML files. These XML files then will be applied to existing project effectively changing its configuration. In case of any problems (compilation failures, runtime errors, etc), new changes will not be applied, and current project settings will be preserved on the server.
  • once project is switched to Kotlin, project settings web UI will become disabled (except a few pages: Versioned settings, Maven Settings, SSH keys and Meta-runners), because currently there is no way to propagate changes made via web UI to Kotlin DSL files.
  • Kotlin script is executed on the server, and since this is a potentially dangerous operation, the script is executed in sandbox. It cannot modify file system except the place where it is executed, cannot run other programs, cannot use reflection, and so on.

Examples of a Project defined in Kotlin DSL:

Smart checking for changes interval

Traditionally TeamCity uses polling for detecting changes in VCS repositories. Polling is a highly reliable approach suitable in the majority of cases. Even if the TeamCity server was stopped for a while, with polling it can easily pickup all the changes made in repositories on the next startup.

But polling has one downside which becomes more and more important, as TeamCity installation grows. If there are many different VCS repositories configured in TeamCity, polling can impose significant load on both TeamCity server and VCS repository servers.

The alternative approach is to use the push model: various post commit hooks and web hooks. This approach is more scalable, but it cannot be used alone: if the TeamCity server is stopped, obviously all push notifications will be lost.

This is why we decided to implement a combined approach. Starting with this EAP, if a commit hook initiates the process of checking for changes for some VCS root in TeamCity, TeamCity will automatically increase checking for changes interval for this VCS root, assuming that this commit hook will now come to TeamCity on a regular basis. But, if so happens that TeamCity detects a change in this VCS root during regular polling, then the checking for changes interval will be reset to the initial value specified by the user when the VCS root was created. This is done for the case when a commit hook stopped working for some reason. If the TeamCity server was restarted, it will switch to polling for all of the VCS roots, till commit hooks start informing it about new commits.

Please refer to our documentation on commit hooks configuration in various VCS repositories. 

Project Configuration Export  

It is now possible to export configuration files for a project with its children as a zip archive to move it to a different TeamCity server. The Project Settings | Settings Export page allows exporting the config files for a project and its subprojects, as well as external dependencies, i.e. build configurations used in snapshot dependencies, templates used as well as vcs roots and all main settings (ssh keys, issue trackers, oauth connections etc...) defined in the parent project.  

The settings archive also contains a report.log file detailing the reasons for exporting external entities.

GitLab support in Commit Status Publisher

The Commit status publisher build feature now supports GitLab thanks to an external contribution.

Support for Perforce Jobs

If you use Perforce jobs to label your commits,  the changes associated with jobs are now marked with a "wrench"  icon   in the TeamCity UI. Navigating to the icon opens a pop-up with the job information:


Refreshed web UI 

In this EAP projects and build configurations as well as collapse/expand actions received new icons. Overall, the UI boasts of a refreshed look and feel.

Cloud support

  • It is now possible to run a custom script on the launch of an Amazon EC2 instance  (applicable to instances cloned from AMI's only).  The Amazon website details the script format for Linux and Windows.
  • Unique hostnames for Windows vSphere cloud agents on  can be specified now: when adding an image, choose a customization spec in the corresponding field. The option is available for Linux VMs as well.

Bitbucket Cloud Issue Tracker

TeamCity comes with built-in support for many of issue trackers, which now include Bitbucket cloud.  The integration with Bitbucket cloud issue tracker can be set up separately, or as a part of TeamCity integration with Bitbucket source code hosting service making it easy to connect TeamCity to Bitbucket issues.

Flaky Test Detector

REST API enhancements

With the latest REST API version it is now possible to:

  • list the agents compatible with a build configuration and filter agents by compatible build configurations. This does not include cloud agents, not yet exposed via REST.
  • get the projects and build configurations as well as their order on the Overview page as configured by the specified user
  • disable/enable artifact dependencies and agent requirements
  • get the build's test occurrences in the order they were run in the build
  • get all currently failing tests runs from the build
  • get all runs (the number of test invocations) for a test
  • get test mutes affecting a specific build configuration

Bundled Tools updates

  • the bundled Ant is updated to 1.9.7
  • the bundled dotCover is updated to 2016.1

Git LFS support

TeamCity now has support for Git LFS if checkout on agent is used.

Other Improvements

  • performance of the project and build configuration settings editing has been greatly improved

  • you can now redefine inherited artifact dependencies  in build configurations, the same as agent requirements and other settings 

  • a new option of the Free Disk Space build feature allows you to fail a build if sufficient disk space cannot be freed for the build
  • fixed issues





  • No labels