Overview
For GitLab integrations, there are 2 high level steps
Generate Personal Access Token
Provide Access Token to Haystack from the integrations page
(Only self-hosted) Open GitLab firewall to Haystack IPs
Afterward, you’ll be able to see your organization's data on https://dash.usehaystack.io, get all updates at the same speed as Cloud users.
You can find detailed instructions on each step below.
Generate Personal Access Token
You can create as many personal access tokens as you like from your GitLab profile.
Log in to GitLab.
In the upper-right corner, click your avatar and select Settings.
On the User Settings menu, select Access Tokens.
Choose a name and optional expiry date for the token - Don't set any date.
Choose the desired scopes - For Haystack we need only api scope and read_user scope..
Click the Create personal access token button.
Save the personal access token somewhere safe. Once you leave or refresh the page, you won’t be able to access it again.
Here is the example:
Copy/Paste your Access token
Go to Haystack, and paste the access token and your GitLab base url.
Click Test & Save, if everything works fine you will be redirected to the integrations page and you will be able to see your integration details
You have installed Haystack on your GitLab organization successfully! Fetching the data might take up to 24 hours. Our team will reach out to you once your data is fetched.
GitLab base URL is for the self-hosted instances!
(Only self-hosted) Open GitLab firewall to Haystack IPs
Haystack API uses the following IP addresses to connect to GitLab.
35.209.159.249
35.208.83.132
35.208.18.170
35.209.170.63
For Haystack to access your servers, we'll need open firewall access to the given IPs.