GitLab

Overview

GitLab is a web-based DevOps platform that allows software development teams to collaborate, manage source code repositories, track issues, and automate the software delivery pipeline.

Entitle can manage groups (all versions) and projects (on-prem version only) in GitLab.

This page will provide you with instructions on how to integrate Entitle and GitLab.

General guidelines

To integrate your GitLab in Entitle, you will need to create a Personal Access Token.

Set up Gitlab to work with Entitle

Stage 1: Obtain your GitLab domain

1. Copy the domain you use to log in to GitLab.
2. If you don’t use a self-hosted GitLab domain, the domain is https://gitlab.com.

Stage 2: Create a Personal Access Token

1. In the upper-right corner, select your avatar.
2. Select Edit profile.

3. On the left sidebar, select Access Tokens.
4. Enter a name and expiry date for the token.
5. The token expires on that date at midnight UTC.
6. If you do not enter an expiry date, the expiry date is automatically set to 365 days later than the current date.
7. Select the api scope.
8. Select Create personal access token, and copy it to your clipboard. You will need it for the configuration later on in this guide.

Create the integration in Entitle

All that is left to do is create an integration on the Entitle application.

1. Log into Entitle and navigate to the Integrations page.
2. After clicking the Add Integration button, type GitLab in the Application field.
3. Don’t forget to set the Save on field with your configuration, i.e. your own hosted agent or Entitle’s cloud.

4. Under the 'domain' field, fill in your GitLab domain URL.
   1. If you don’t use a self-hosted GitLab domain, fill in https://gitlab.com.
5. Under the 'private_token' field, fill in your Salesforce domain URL.
6. Example connection JSON:

{
  "domain": "<YOUR_GITLAB_DOMAIN>",
  "private_token": "<YOUR_PRIVATE_TOKEN>"
}

7. Click Save, you are done!