JetBrains Space Help

CI Server Integration

Integration with an external CI server (Continuous Integration server) allows Space to receive and display commit statuses for a particular project. Project participants can see which builds have passed and failed for each commit and view information about automation tasks involved.

Space API supports HTTP requests from external CI servers (Report external check status).

Setting up the integration is a lot easier if you're using TeamCity for testing and building your project as it's pre-configured to work with Space. The integration is available in TeamCity version 2020.2 and newer.

To start receiving commit statuses from TeamCity you need to:

  • Create a new OAuth 2.0 application in Space and authorize it for your Space project.

  • Configure your TeamCity project to work with your Space project.

Create and authorize an application in Space

  1. On the navigation bar, click administration.png Administration.

  2. On the Administration sidebar, choose Applications.

  3. Click the New application button.

  4. Give your application a unique name and click Create.

  5. Open the Requested rights tab, scroll to the Git repositories section, and select the Report external check status checkbox.

  6. Authorize the application for your project:

    • Open the Authorization tab.

    • Click Add project and choose your project from the list.

    • Click Authorize.

  7. Open the Authentication tab and select the Client Credentials Flow checkbox and click Save.

    The Authentication tab contains credentials (client secret, client ID) that Space generated for your application. You will need to provide these credentials to TeamCity later on.

Configure your TeamCity project

There are two way to configure your TeamCity project:

  • Create a new Connection, providing project credentials from Space, then select this connection when adding the Commit Status Publisher build feature.

  • Directly specify the project credentials from Space when adding the Commit Status Publisher build feature.

Create a new Connection

  1. Open your project in TeamCity.

  2. Go to Project Settings → Connections → Add Connection

  3. Specify the following information:

    • Connection Type: JetBrains Space

    • Display name: <The name that will be displayed in the TeamCity UI>

    • Space URL: <Your Space public URR> (e.g. mycompany.jetbrains.space)

    • Service ID: <Client ID from the service you created in Space>

    • Service secret: <Client secret from the service you created in Space>

  4. Open the target build configuration/build configuration template on Build Server.

  5. Go to Edit Configuration Settings → Build Features → Add build feature

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

  7. Specify the following information:

    • Publisher: JetBrains Space

    • Connection Type: Use Space connection

    • Connection: <Choose the connection you just created>

    • Space Project key: <The project key of your Space project (must be upper case)>

    • Commit status publisher display name: <The name that will be displayed in the Space UI when showing data from TeamCity>

  8. Click Test connection to make sure your settings are correct.

  9. Save your settings.

Provide credentials from the Commit Status Publisher

  1. Open the target build configuration/build configuration template on Build Server.

  2. Go to Edit Configuration Settings → Build Features → Add build feature

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

  4. Specify the following information:

    • Publisher: JetBrains Space

    • Connection Type: Use Space service credentials

    • Space URL: <Your Space public URL>

    • Service ID: <Client ID from the service you created in Space>

    • Service secret: <Client secret from the service you created in Space>

    • Space Project key: <The project key of your Space project (must be upper case)>

    • Commit status publisher display name: <The name that will be displayed in the Space UI when showing data from TeamCity>

  5. Click Test connection to make sure your settings are correct.

  6. Save your settings.

Last modified: 18 August 2021