To connect GitLab Pipelines to Unblocked, follow these steps:

1

Add CI Data Source

In the left sidebar, click on Data Sources. Then click on Add another data source and choose Continuous Integration.

2

Connect GitLab Pipelines

Click on the GitLab Pipelines tile.

3

Enable CI Triage

Click Select Repositories to choose the repositories you want to enable CI triage on.

4

Select Repositories

Toggle the repositories you want to enable by selecting them.

5

Create a Bot Account

CI analysis reports need to be posted on behalf of a GitLab user account. We recommend creating an Unblocked bot account for this specific purpose.

Already have a bot account?

Some teams already have a bot account they use for posting automated messages. If you already have a bot account that you can repurpose for posting CI analysis reports, select it and skip to the next step.

  • Create a new account in GitLab.
  • Click on your avatar in the top left, and click Edit Profile.
  • Change the following information:
    • Name: Unblocked
    • Avatar: download and use the Unblocked logo below
  • Sign out of your GitLab bot account.
  • Sign in as a Group admin for your GitLab Group and navigate to it.
  • Click Manage in the left navigation and select Members.
  • Click Invite members
  • Set the maximum role as “Planner” and click “Invite”.
6

Select your Bot Account

Search for the Bot Account you just created and select it. You may be required to authorize this account with Unblocked.

In order to successfully authorize your bot account, you need to be logged in with that account in GitLab.

7

Done

Click Save Settings to apply your changes. Now Unblocked will analyze CI failures in the selected repositories and post reports to pull requests.