Integrating TeamCity with VCS Hosting Services

Connecting to GitHub

You need to configure a connection to your GitHub repository to create a project from URL, create a VCS root from URL, create a Git VCS root or create GitHub issue tracker.

To configure a GitHub connection:

1. In Project Administration | Connections, click Add Connection.

2. Select GitHub as the connection type. The page that opens provides the parameters to be used when registering your TeamCity application in GitHub service.

3. Click the register application link. The GitHub page opens.
   You need to register TeamCity as an OAuth application in GitHub.
   The following steps are performed in your GitHub account:

   • Log into your GitHub account. On the Register a new OAuth application page specify the name and an optional description, the homepage URL and the callback URL as provided by TeamCity.

   • Click Register application. The page is updated with Client ID and the client secret information for your TeamCity application.

4. Continue configuring the connection in TeamCity: on the Add Connection page that is open, specify the Client ID and the client secret.

5. Save the connection settings.

6. The connection is configured, and now a small GitHub icon becomes active in several places where a repository URL can be specified: create project from URL, create VCS root from URL, create Git VCS root, create GitHub issue tracker. Click the icon, log in to GitHub and authorize TeamCity. The authorized application will be granted full control of private repositories and the Write repository hooks permission.

Connecting to Bitbucket

You need to configure a connection to your public Bitbucket repository to create a project from URL, create a VCS root from URL, create a Mercurial VCS root, or create a Bitbucket issue tracker.

To configure a Bitbucket connection:

1. In Project Administration | Connections, click Add Connection.

2. Select Bitbucket as the connection type.
   The page that opens provides the parameters to be used when registering an OAuth consumer on Bitbucket Cloud. Click the register application link.
   You need to create an OAuth consumer on Bitbucket Cloud. The following steps are performed in your Bitbucket account:

   1. Log into your Bitbucket account, click your avatar and select Bitbucket settings from the menu. The Account page appears.

   2. Click OAuth from the menu bar. On the Add OAuth consumer page, specify the name and an optional description, the callback URL and the URL as provided by TeamCity.

   3. Specify the set of permissions: TeamCity requires "read" access to your account and your repositories.

   4. Save your settings.

   5. On the page that opens, in the OAth consumers section, click the name of your TeamCity application to display the key and the secret.

3. Continue configuring the connection in TeamCity: on the Add Connection page that is open, specify the key and secret.

4. Save the connection settings.

5. The connection is configured, and now a small Bitbucket icon becomes active in several places where a repository URL can be specified: create project from URL, create VCS root from URL, create Mercurial VCS root, create Bitbucket issue tracker. Click the icon, log in to Bitbucket and authorize TeamCity. TeamCity will be granted access to your public repositories. For private repositories you'll still have to sign in to Bitbucket as it doesn't provide non-expiring access tokens. See the related discussion.

Connecting to GitLab

You need to configure a connection to your public GitLab repository to create a project from URL or create a VCS root from URL.

To configure a GitLab connection in TeamCity:

1. In Project Administration | Connections, click Add Connection.

2. Select GitLab.com or GitLab CE/EE as the connection type.

3. TeamCity will display the Redirect URL required for registering an OAuth application in GitLab.
   To register the application, follow this instruction. Insert the TeamCity Redirect URL as Redirect URI and select the api scope. Save your application, and copy the secret and application ID generated by GitLab.

4. Once ready, go back to configuring the connection in TeamCity and fill in the following fields:
   • Application ID
   • Secret

   • Server URL (only for GitLab CE/EE)

5. Save the connection settings.

6. The connection is configured, and now a small GitLab icon becomes active in several places where a repository URL can be specified: create project from URL and create VCS root from URL. Click the icon, sign in to GitLab, and authorize TeamCity. TeamCity will be granted access to your repositories.

note

When creating a VCS root URL for GitLab, note that TeamCity will not extract credentials from the root URL, so you need to specify a username and password manually.

Connecting to Azure DevOps Services

You can configure a connection to your Azure DevOps Services (or Azure DevOps Server, formerly Team Foundation Server) to create a project from URL, create a VCS root from URL, create TFS VCS root, or create Team Foundation Work Items tracker.

To configure a connection to Azure DevOps Services, follow these steps:

1. In Project Administration | Connections, click Add Connection.

2. Select Azure DevOps Services as the connection type.
   The page that opens provides the parameters to be used when connecting TeamCity to Azure DevOps Services.

3. Log in to your Azure DevOps Services account to create a personal access token with All scopes as described in the Microsoft documentation.

4. Continue configuring the connection in TeamCity: on the Add Connection page that is open, specify

   • the server URL in the https://{account}.visualstudio.com format or your Team Foundation Server web portal as https://{server}:8080/tfs/

   • your personal access token

5. Save the connection settings.

6. The connection is configured, and now a small Azure DevOps Services icon becomes active in several places where a repository URL can be specified: create project from URL, create VCS root from URL, create TFS VCS root, create Team Foundation Work Items tracker. Click the icon, log in to Azure DevOps Services and authorize TeamCity. TeamCity will be granted full access to all of the resources that are available to you.
   Since TeamCity 2017.2 EAP1, when configuring Commit Status Publisher for Git repositories hosted in TFS/VSTS, the personal access token can be filled out automatically if a VSTS project connection is configured.

tip

It is possible to configure several VSTS connections. In this case the server URL will be displayed next to the VSTS icon to distinguish the server in use.