How it works

The GitLab Connector picks up all of the Merge Requests and Issues in a specified repository.

  • It will index both Open and Closed MRs. This includes the Title and Summary.
  • It will index Issues (and Incidents) including comments both Open and Closed.
  • Includes certain other metadata such as the URL, creator, etc.

Setting up

Authorization

  1. This Connector uses a GitLab Access Token.
  2. Log in to GitLab.
  3. On the left sidebar, select your avatar.
  4. Select Edit profile.
  5. Select Add new token.

  1. Enter a name and expiry date for the token.
    • The token expires on that date at midnight UTC.
    • If you do not enter an expiry date, the expiry date is automatically set to 365 days later than the current date.
    • By default, this date can be a maximum of 365 days later than the current date.
  2. Select the desired scopes, further details here.
  3. Select Create personal access token.

Indexing

  1. Navigate to the Admin Dashboard and select the GitLab Connector
  2. If you’re using GitLab Cloud and not self-hosting, keep the GitLab URL as the default
  3. For a project with a url such as “https://gitlab.com/onyx-ai/onyx”, configure it as below: