TeamCity 9.0 Help

IntelliJ Platform Plugin

TeamCity plugin provides TeamCity integration for IntelliJ Platform-based IDEs, including IntelliJ IDEA, RubyMine, PhpStorm, WebStorm, etc. See a separate page for the list of supported versions.

Features

TeamCity integration provides the following features:

  • Remote Run and Pre-Tested (Delayed) Commit,

  • customizing parameters for personal builds,

  • Remote Debug

  • possibility to review the code duplicates,

  • analyzing the results of remote code inspections,

  • monitoring the status of particular projects and build configurations and the status of changes committed to the project code base,

  • viewing failed tests and build logs with highlighted stacktraces and current project file names,

  • start investigation of a failed build,

  • assign investigation of a build configuration problem or failed test form the plugin to another team member,

  • viewing build failures, which you are supposed to investigate, and giving up investigation when the problem is fixed,

  • applying quick-fixes to the results of remote code analysis: the problematic code can be highlighted in the editor and you can work with a complete report of the project inspection results in a toolwindow,

  • downloading and viewing only the new inspection results that appeared since the last build was created

  • work with the results of server-side code duplicates search in the dedicated toolwindow,

  • accessing the server-side code coverage information and visualizing the portions of code covered by unit tests,

  • viewing build compilation errors in a separate tab of the build results pane with navigation to source code,

  • re-rununing failed tests from IntelliJ IDEA plugin using JUnit or TestNG,

  • opening the patch from the change details web page (for this feature to work you need to have IDEA X installed).

Installing TeamCity plugin

TeamCity IDE plugin version should correspond to the version of the TeamCity server it connects to. Connections to TeamCity servers with different versions are generally not supported.

Installing the Plugin from the Plugin Repository

The plugin repository has a TeamCity plugin from one of the recently released versions. You can install the plugin from repository (e.g. from IntelliJ IDEA Settings > Plugins), then enter the address of your local TeamCity server and let the plugin update itself to the version corresponding to the server.

To install the TeamCity plugin for IntelliJ platform IDE:

  1. In IDE, open the Settings dialog. To do so either press Ctrl+Alt+S or choose File > Settings... (Apple > Settings... on Mac OS X) from the main menu.

  2. Open Plugins section under IDE Settings to invoke the Plugins dialog.

  3. On the Plugins dialog, open the Available tab or click Install JetBrains plugin... to view the list of available plugins.

  4. Select the TeamCity plugin, click the Install button.

  5. Restart the IDE.

  6. Log in into TeamCity server from the plugin.

  7. Invoke the Update command in the TeamCity menu to install the plugin version matching the server version.

Installing the Plugin Manually

The plugin for IntelliJ platform can be downloaded from the TeamCity Tools area on the My Settings & Tools page of TeamCity web UI.

To install the TeamCity plugin:

  1. In the top right corner of the TeamCity web UI, click the arrow next to your username, and select My Settings & Tools.

  2. Under the IntelliJ Platform Plugin section in the TeamCity Tools area, click the download link, and save the archive.

  3. Make sure that IDE is not running and unzip the archive into the IDE user plugins directory.

Plugins directory for IntelliJ IDEA is located in:

  • Windows: C:\Documents and Settings\<username>\.IntelliJIdea<vers.>\config\plugins

  • OS X: $HOME/Library/Application Support/IntelliJIDEA<vers.>

  • Linux/Unix: $HOME/.IntelliJIdea<vers.>/config/plugins

Plugins directory for RubyMine is located in:

  • Windows: C:\Documents and Settings\<username>\.RubyMine<vers.>\config\plugins

  • OS X: $HOME/Library/Application Support/RubyMine<vers.>

  • Linux/Unix: $HOME/.RubyMine<vers.>/config/plugins

All additional information on how to work with TeamCity plugin is available in IDE Help System.

Configuring IntelliJ IDEA-platform based IDE to Check for Plugin Updates

  1. In IntelliJ IDEA, open Settings/ Updates

  2. Add "http://<your_teamcity_server_URL>/update/idea-plugins.xml" to the list

  3. Set "Check for updates" to "Daily"

  4. Press "Apply", then "Check Now"

Troubleshooting: Logging in IntelliJ IDEA/Platform-based IDEs

Last modified: 20 April 2023