CI server integration

Receiving build statuses from TeamCity

Integrating with a TeamCity CI server is provided via a Commit Status Publisher plugin which comes bundled with the TeamCity version 9.1.7 and newer. Configuring it to work with Upsource is easy and is done on the TeamCity side.

To integrate with TeamCity

1. Make sure you have administrator access rights to the project in TeamCity.

2. Go to Settings | Build features | Add build feature.

3. Choose Commit Status Publisher from the drop-down list.

4. Specify the following information:

   • Publisher: JetBrains Upsource

   • Upsource URL: the URL of your Upsource server

   • Upsource project ID: the ID of your Upsource project

   • Username, Password: the authentication token specified in Upsource

     or administrator credentials of the Upsource project.

5. Save your settings.

For more information refer to the TeamCity documentation

Receiving build statuses from other CI servers

Upsource comes with a Build Status Endpoint that is open to receive data as JSON payload at http[s]://your-upsource-server/~buildStatus/.

The POST request should include the following header: Content-Type: application/json; charset=UTF-8

If no credentials are provided, the request will be executed with guest permissions. For a secure connection, send the Authorization header along with your request: Authorization: Basic login:password

Where login:password is the authentication token defined in Upsource.

To make a request on behalf of a specific user, you can provide the users credentials (encoded in Base64) instead of the token.

The POST request body should include the following fields: