Icon

You are viewing the documentation of TeamCity 2018.x, which is not the most recently released version of TeamCity.
View this page in the latest documentation or refer to the listing to choose the documentation corresponding to your TeamCity version.

 

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

hidden-data
=====================================================================
Changes from 2018.2.x to 2019.1
=====================================================================
h3
reverse.dep Changesparameters from 2017.2.x to 2018.1
 
TeamCity is tested only under Apache Tomcat 8.5, earlier Tomcat versions are not supported.
Gerrit 2.6 is the minimal version supported by Commit Status Publisher.
The IntelliJ IDEA Project Runner uses JPS 2017.3.4 requiring Java 1.8 as the minimal version.
 
TeamCity pages are no longer loaded into iframes as a security measure. Plugins providing pages which can be loaded into iframes should make sure that the pages do not perform any modification actions and register the pages via the {{ContentSecurityPolicyFilter.addUnprotectedPath}} API call. See [details|behavior changed: https://youtrack.jetbrains.com/issue/TW-41341

Changes from 2018.2.3 to 2018.2.4

There is a regression in TeamCity 2018.2.4 related to the data displayed on the unauthorized agents' page: the data on agent authorization, enabling/disabling comments, and the latest activity time was removed from the page. This data is displayed on the agent details page.

When the performance is improved, we’ll return the data to the unauthorized agents' page.

Changes from 2018.2.2 to 2018.2.3

TeamCity now ships Windows docker images for 1803/1809 platforms.

Known issues

Running builds are not shown on the build configuration page if there are no finished builds. To workaround the issue, stop the TeamCity server, replace the TEAMCITY_DIRECTORY/webapps/ROOT/js/ring/bundle.js with the bundle.js file  attached to this issue and start the server. 

Changes from 2018.2.1 to 2018.2.2

  • The bundled Tomcat has been updated to version 8.5.3
  • The TeamCity agent docker image supports .NET Core 2.2

Changes from 2018.2 to 2018.2.1

No noteworthy changes

Changes from 2018.1.x to 2018.2

Known issues

  • If upgrade fails with an error in MoveCustomDataStorageToDatabaseConverter or MoveRepositoryStateToCustomDataStorageConverter, please apply workaround from the issue.

  • If you're using Subversion externals from the same repository, you may face an issue with incorrect revision detection. A workaround for the problem is described in this issue.
  • If you see OutOfMemoryError during TeamCity startup with `org.jetbrains.dokka` in stack trace, please set the internal property teamcity.kotlinConfigsDsl.docsGenerationXmx=768m (as described in this issue)

Bundled Tools Updates

  • The bundled .NET Tools (dotCover and ReSharper CLT) have been upgraded to the latest released version, 2018.1.4
  • TeamCity 2018.2 comes bundled with IntelliJ IDEA 2018.3.1. The IntelliJ IDEA Project Runner uses JPS 2018.3.1 
  • Since TeamCity 2018.2 OpenJDK is included in the Windows .exe TeamCity distribution (before 2018.2 Oracle Java was bundled with TeamCity Windows distribution). 

NuGet feed

The parameters that were previously used to reference the global NuGet feed are removed. After upgrading, all of them will be converted to the parameters referencing the default NuGet feed in Root project.

If you're still using deprecated NuGet feed references in project parameters please update them as following:

Global feed nameProject feed name
teamcity.nuget.feed.serverteamcity.nuget.feed.guestAuth._Root.default.v2
teamcity.nuget.feed.auth.serverteamcity.nuget.feed.httpAuth._Root.default.v2
system.teamcity.nuget.feed.auth.serverRootUrlBased.serverteamcity.nuget.feed.httpAuth._Root.default.v2

Changes from 2018.1.4 to 2018.1.5

No noteworthy changes

Changes from 2018.1.3 to 2018.1.4

Known issues

  • Builds which are running while the server upgrades to 2018.1.4 can get their build log and status truncated, not duly reporting build failure. The build log gets warning with "__tc_longResponseMarker" text (details). It is recommended to wait till there are not running builds when upgrading to this version.

Misc

Support for Microsoft Internet Explorer 10 is discontinued in TeamCity 2018.1.4.

Changes from 2018.1.2 to 2018.1.3

Bundled Tools Updates

The latest JaCoCo version (0.8.2) has been added to TeamCity.

Known issues

If you use JaCoCo coverage and you decide to downgrade from TeamCity 2018.1.3+ to TeamCity versions 2018.1 - 2018.1.2,  you may experience issues requiring manual fixes to make the affected configurations work again.

Changes from 2018.1.1 to 2018.1.2

Known issues

If you are using tcWebHooks third-party TeamCity plugin, update it to the latest version before upgrading (details).

hidden-data
(this was a bug existing since version 9.1, so seems like we do not need to announce it's fixing in 2018.1.2 here - https://youtrack.jetbrains.com/issue/TW-33819].

h4. NuGet feed
* NuGet feed was moved from the server level to the project level: now each project can have its own feed. The "NuGet packages indexer" build feature can be added to build configurations whose artifacts should be indexed.
* Starting from TeamCity 2018.1, .nupkg files will be indexed on the agent side which could slightly increase the time of builds for projects with the NuGet Feed feature and the automatic package indexing enabled or for builds with NuGet Packages Indexer build feature.
* The following NuGet feed-related parameters are deprecated:
** {{42962)
h3. Agent configuration on upgrade
If you choose to perform upgrade of a TeamCity agent running under Windows using TeamCity Windows agent or server installer and the previous agent version is 9.1+ (regularly, agent upgrades automatically and you do not need to run the installer manually), in order not to lose agent settings stored in <TeamCity Agent Home>\config\buildAgent.properties, backup the file before running the installer and restore the file from the backup after the installation procedure.
 

We increased accuracy for recognizing similar TeamCity exit code build problems. The existing investigations and mutes for these build problems will be reset.

Bundled Tools Updates

The bundled Tomcat has been updated to version 8.5.32.

Changes from 2018.1 to 2018.1.1

Known issues

If you're upgrading from 2018.1 to 2018.1.1 and you want to see the NuGet packages missing due to issues TW-55703 and TW-55833, do the following:

  • Cleanup .teamcity/nuget/packages.json files in the build artifacts. Consider using this PowerShell script:

    Code Block
    > cd "%TeamCityDataDir%\system\artifacts\"
    > Get-ChildItem -Recurse | Where-Object { $_.FullName -match '\.teamcity\\nuget\\packages\.json' } | Remove-Item
  • On the Administration | Diagnostics | Caches page, reset the "buildsMetadata" cache and wait while re-indexing is finished. To temporary increase indexing speed, see the following tip.

Docker Images

Since 2018.1.1 TeamCity has multi-platform docker images marked by the "latest" and version number tags published in Docker Hub, e.g. "jetbrains/teamcity-server", "jetbrains/teamcity-server:2018.1.1". This allows using the same docker image reference for Linux and Windows docker containers, see TW-55061 for details.

Changes from 2017.2.x to 2018.1

Known issues

While publishing NuGet packages into the TeamCity NuGet feed in multiple build steps, only the packages published by the first build step will be visible. See TW-55703 for details. If you experience problems with download of NuGet packages published within archives see TW-55833.

Stricter rules for parameter names used in parameter references

Names of the Build Configuration parameters are now validated in more strict manner. While already existing parameters should continue to work, it is highly recommended to review the names and use Latin letters and no special symbols. Details

User self-registration

If you have Built-in authentication enabled with the "Allow user registration from the login page" setting on, the setting will be disabled on upgrade. If you need the registration, make sure the server is not open to unauthorized users access (e.g. not accessible from Internet) and enable the setting via the health item displayed at the top of the administration pages or in the "Administration | Authentication" under the "Built-in" module settings.

Bundled Tools Update

  • The IntelliJ IDEA Project Runner uses JPS 2017.3.4 requiring Java 1.8 as the minimal version.
  • The bundled ReSharper CLT and dotCover have been updated to version 2018.1.2

NuGet feed

  • Configuration of the NuGet feed was moved from the server level to the project level: now each project can have its own feed. The "NuGet packages indexer" build feature can be added to build configurations whose artifacts should be indexed.
  • The following NuGet feed-related build parameters are deprecated:

    • teamcity.nuget.feed.auth.server

...

    • teamcity.nuget.feed.server

...

    • system.teamcity.nuget.feed.auth.serverRootUrlBased.server

...

    You now need to explicitly specify the URL from the NuGet Feed page in the project settings.
  • The enabled default NuGet feed with all published packages accessed by URL /app/nuget/v1/FeedService.svc/ is now moved to the Root project feed /app/nuget/feed/_Root/default/v2/. It is recommended to switch to new URL in your projects.
  • .nupkg files are now indexed on the agent side instead of the server which could slightly increase the time of builds for projects with the NuGet Feed feature and the automatic package indexing enabled or for builds with NuGet Packages Indexer build feature.

REST API

REST API uses version 2018.1. The previous versions of the API are still available under /app/rest/2017.2, /app/rest/2017.1 (/app/rest/10.0), app/rest/9.1, /app/rest/9.0, /app/rest/8.1, /app/rest/7.0, /app/rest/6.0 URLs. It is recommended to stop using previous APIs URLs as we are going to remove them in the following releases.

Filtering builds by agent names

When agent name contains the parentheses symbols, instead of using agentName:<name>, use "agentName:(value:<value>)

Locators with "value:<text>"

Requests which used "value:<text>" locators (e.g. for matching properties) and no "matchType" dimension specification will start to use "equals" matching by default. Add "matchType:contains" to preserve the old behavior. Details

VSS plugin is unbundled

The Visual SourceSafe plugin is no longer bundled with TeamCity but is available as a separate download. Please contact our support, if you still use this VSS for your builds.

Other

  • Commit Status Publisher supports Gerrit 2.6+ versions. For support for older Gerrit versions, please turn to our support.
  • When upgrading from TeamCity versions before 9.1, if TeamCity 2018.1 starts and agents are upgraded, but then you decide to roll back the server to the previous TeamCity version, the agents will not be able to connect back to the old server and will need to be reinstalled manually.
  • Make sure that no HTTP requests from the agents to the server are blocked (e.g. requests to .../app/agents/... URLs)
  • Since 2018.1, TeamCity uses the full project name with "/" instead of "::" as the separator for Project - Subproject wherever the full project name is present.

Changes from 2017.2.3 to 2017.2.4

...

Changes from 2017.2.2 to 2017.2.3

Build revisions

In all the build configurations, the builds run before the upgrade will not be reused in the chains and will run anew (only the last build on the default branch is affected if branches are used). This may also result in a clean checkout in the first run build for VCSs like Perforce. The behavior is similar tothat after VCS root editing.

hidden-data
https://youtrack.jetbrains.com/issue/TW-56187

Security

When upgrading to 2017.2.x versions (please ignore when upgrading to 2018.1 and further versions): It is recommended to add " teamcity.artifacts.restrictRequestsWithArtifactReferer=trueinternal property to enhance security of the server.

hidden-data
https://youtrack.jetbrains.com/issue/TW-27206

...

Note: The DotNetCore and DotNetCore_Path agent configuration parameters  will be changed to  DotNetCLI and DotNetCLI_Path; please consider updating your agent requirements which depend on these parameters.

REST API

REST API uses version 2017.2. The previous versions of the API are still available under /app/rest/2017.1 (/app/rest/10.0), app/rest/9.1, /app/rest/9.0, /app/rest/8.1, /app/rest/7.0, /app/rest/6.0 URLs.

 

buildType entity 

has "templates" sub-element now instead of "template" to support multiple templates.

...

Windows XP and Vista are no longer the supported versions of Windows for the TeamCity Server and Agent. While the server and agent can will still most probably work on these old versions, we do not target the versions during our development. Let us know if the support for the versions is important for your TeamCity usage or you find any issues with the systems support.

J2EE Servlet 2.5 container is no longer supported

J2EE Servlet container version 2.5 is not supported since TeamCity 2017.2. TeamCity does not guarantee support for Tomcat 6.x and Jetty 7.x implementing Servlet 2.5. For .war distribution (not recommended, .tar.gz distribution is recommended), TeamCity supports Apache Tomcat 7+, J2EE Servlet 3.0+ and JSP 2.2+.

Other

  • The bundled Tomcat 8.5. restricted usage of special characters in the URL including curly bracket symbols ({ }). Details.
  • TeamCity integration with Intellij-based IDEs no longer supports StarTeam and Visual Source Safe version controls.

...

Changes from 2017.1.3 to 2017.1.4

Known issues

TFS Personal support lists all build configurations for TFVC VCS root. See TW-51497 for details.

...

Changes from 10.0.x to 2017.1

Known issues

Editing cloud profile cancels all builds on profile agents. See TW-49616 for details.

...

Anchor
restApi2017_1
restApi2017_1

REST API

REST API has only minor changes, so the same API is exposed under the app/rest/10.0 and /app/rest/2017.1 URLs. API version has been updated to 2017.1 though to reflect the changes.
The build's node "triggeredBy" now has more correct values of "type" attribute for the builds started after 2017.1 upgrade. In particular, the "buildType" value is not used anymore, the"finishBuild", "snapshot", etc. values are used instead.

...

Precedence of %dep.ID.NAME% parameter references

When %dep.ID.NAME% parameter reference is used and there are several dependency paths to the same build configuration with id "ID" so that different builds are accessible via (direct or indirect) artifact dependencies, the result of the reference resolution could have used any of the builds without any guaranteed precedence.

...

Old keys are still supported in charts definitions.

Anchor
restApi10
restApi10

REST API

REST API uses version 10.0.  The previous versions of the API are still available under /app/rest/9.1, /app/rest/9.0, /app/rest/8.1, /app/rest/7.0, /app/rest/6.0 URLs.

...

Changes from 9.1.1 to 9.1.2

Known issues

The Command line runner can fail to execute a custom script if it has a non-default hashbang specified at the beginning of the script: TW-42498

...

Perforce VCS Roots with disabled ticket authentication won't run 'p4 login' operation anymore if password authentication is disabled on the Perforce server.
I.e. if password authentication is disabled, "Use ticked-based authentication" option must be enabled on the VCS Root. TW-42818

 

Changes from 9.0.x to 9.1

...

Anchor
9.1restapi
9.1restapi

REST API

REST API uses version 9.1. Previous versions of API are still available under /app/rest/9.0, /app/rest/8.1, /app/rest/7.0, /app/rest/6.0 URLs.

...

Anchor
9.0restapi
9.0restapi

REST API

REST API uses version 9.0. Previous versions of API are still available under /app/rest/8.1, /app/rest/7.0, /app/rest/6.0 URLs.

...

Besides, it will not use the settings provided by the 8.1 version. The traditional add-in downloaded from TeamCity server can still use settings from previous version.

Other

TeamCity agent installation via the Java web start installation package is no longer available.

...

The change in behavior introduced in 8.1 (see below) has been fixed. Command line runners using "Executable with parameters" option which were created/changed with TeamCity 8.1
can expose a change in behavior with the upgrade. The recommended approach is to switch to "Custom script" option instead of "Executable with parameters" in command line runner.

...

Anchor
8.1restapi
8.1restapi

REST API

The latest version of the API has not changed, it is still "8.0" while there are changes in the API detailed below. If you find this inconvenient for your REST API usages, please comment in the corresponding issue.

...

If you use JetBrains YouTrack and use its TeamCity integration features, please note that only YouTrack version 4.2.4 and later are compatible with TeamCity 8.0.
If you need earlier YouTrack versions to work with TeamCity 8.0, please let us know.

Wiki Markup
{hidden-data}
on TeamCity-YouTrack compatibility:

TeamCity 8.0 introduces several changes in the latest version of its REST API which are not compatible with versions of YouTrack prior to 4.2.4. Since YouTrack is not able to use previous versions of the API bundled with TeamCity, this makes the versions incompatible.

There still is a workaround from TeamCity side to make the latest version of REST API behave in backward-compatible mode for the YouTrack-integration relevant calls.
Namely, you can add the following TeamCity internal properties:
rest.compatibility.allowExternalIdAsInternal=true
rest.beans.build.inlineRelatedIssues=true
No server restart is required.

This should make TeamCity 8.0 compatible with previous versions of YouTrack.
Please note that it is not recommended to use the options in a long run and they should be removed once you upgrade to the compatible YouTrack version.

Also, as we want to monitor the demand for the compatibility, please do not publicly share the solution provided. We will do so once we receive more inquires.
{hidden-data}
Anchor
8.0-restapi
8.0-restapi

REST API

External ids
There are changes in the API related to the new external ids for project/build types/templates as well as other changes.
The old API compatible with TeamCity 7.1 is still provided under "/app/rest/7.0" URL.

...

The [bug with temp tool folders|https://youtrack.jetbrains.com/issue/TW-46648] introduced in the previous version has been fixed.

To fix the issue please stop TeamCity server, replace TEAMCITY_DIRECTORY/webapps/ROOT/js/ring/bundle.js with the bundle.js attached to the issue and start the server.