In this topic:
- What is TeamCity Add-in?
- Installation and Start
- Connecting to a TeamCity server
- Making Necessary Configurations
What is TeamCity Add-in?
If you use TeamCity continuous integration server to build and test your Visual Studio projects, TeamCity add-in can help you access, execute, and analyze builds and tests on your TeamCity server without leaving Visual Studio.
You can get the most from TeamCity Add-in when working with centralized version control systems (VCS) (like Perforce, Subversion, or Team Foundation Server), where light feature branches are not a part of the workflow. For these VCSs, TeamCity Add-in provides the possibility to run personal builds so that you can test your local changes on your TeamCity server before you commit them to your VCS.
Installation and Start
TeamCity Add-in is distributed as a part of ReSharper Ultimate installer, which you can download in several ways:
- In your TeamCity web interface, choose My Settings and Tools under your username in the top right corner. Then, in the TeamCity Tools section on the right, click the Visual Studio Add-in download link.
- Download any of compatible JetBrains .NET products, e.g. ReSharper or dotCover.
When the download is complete, close all Visual Studio instances, run the installer and follow its instructions to finish the installation.
Note that the installer will suggest you to install other JetBrains tools from the ReSharper Ultimate bundle or update the existing ones if necessary. You will be able to choose to install free 30-day trial versions of these products together with TeamCity Add-in or not to install them at all. For more information, see ReSharper Ultimate installation guide.
Connecting to a TeamCity server
To start using TeamCity Add-in, you need to establish a connection between it and your TeamCity server. More specifically, as different solutions can be built on different TeamCity servers, you need to link each solution that you work on with a TeamCity server.
You can either choose in the main menu or right-click on the cloud icon in the right part of the Visual Studio status bar and choose Login. In the dialog box that appears, specify the URL of your TeamCity server and your credentials, and then click OK.
As soon as the connection established, the cloud icon in the Visual Studio status bar turns green and you are ready to view your commits and related builds in the My Changes Window.
Making Necessary Configurations
To enable personal build, remote run, pre-tested commit, as well as to be able to view, commit, and revert your local changes in the Local Changes Window, you need to specify the VCS you use for your solution in the TeamCity Add-in options (ReSharper | Options | TeamCity | Source Control). Supported VCSs include Perforce, Subversion, and Team Foundation Server.
To be able to view diffs for local changes in the Local Changes Window, you need to configure an external diff tool of your choice in the TeamCity Add-in options (ReSharper | Options | TeamCity | External Diff Viewer).