By connecting Super with your GitLab account, you can instantly search for all your issues and merge requests directly in Super.
This guide will walk you through the key aspects of the Super and GitLab connection.
Connecting GitLab & Super
This is the first step to get started. This section covers how to set up the connection between your Super and GitLab accounts.
Required Permissions for Setup
To connect Super with GitLab, you must have the necessary permissions in both platforms.
In Super: Permission to add or remove data sources depends on your team's settings. By default, only Admins or Owners can set up a connection. However, a Super Admin can enable a setting to allow all members to add or remove data sources.
Before you can start indexing GitLab projects, you will need to create a service account as well as an access token:
In Super, click Data Sources in the sidebar.
Find the GitLab option and click Connect GitLab.
Follow the on-screen instructions to create a service account and an access token.
Paste your GitLab access token, then click "Connect team".
Your GitLab projects will start syncing.
How Super Indexes Your GitLab Projects
What We Sync
Super syncs issues and merge requests from your GitLab projects. We do not sync your code, private user data, comments, commit history, or internal GitLab analytics.
Issues: All issue descriptions from connected projects.
Merge Requests: All merge request descriptions from connected projects.
Refresh Rate
When you create, update, or close issues and merge requests in GitLab, these changes will be reflected in Super's search index after 6 hours.
When a project is first connected, Super performs an initial import of all issues and merge requests that have been modified within the last 365 days.
Metadata
To make your search results more useful, Super automatically pulls and indexes key information from your GitLab content. This includes:
For Issues & Merge Requests:
Title and content of the issue or merge request
Number, state (open/closed/merged), and lock status
Creation, modification, and closure/merging dates
Assignee, creator, and reviewer information
Labels, milestone, and review comments
A direct link to the GitLab issue or merge request
Access Control & Privacy
Anyone from your Super organization will be able to access content from connected GitLab projects.