Prerequisites

• An active GitLab account from which data is to be ingested exists.

• The access token is available to authenticate Hevo on your GitLab account.

• You are logged in as an Admin user to obtain the access token. Else, you can obtain the access token from your administrator. Read User Types to know about the different types of user accounts and permissions related to them in GitLab.

• You are assigned the Team Administrator, Team Collaborator, or Pipeline Administrator role in Hevo to create the Pipeline.

Creating the Access Token

You need an access token to authenticate Hevo on your GitLab account.

Note: You must log in as an Admin user to perform these steps.

Perform the following steps to create the access token:

1. Log in to your GitLab account.

2. Click on your profile picture in the top left corner, and select Preferences.

   

3. In the left navigation pane, under the User Settings, click Access Tokens.

   

4. On the Personal access tokens page, click Add new token.

   

5. In the Add a personal access token section, specify the following:

   

   • Token Name: A name for your access token.

   • Expiration date: The date on which the token expires.

     Note: You must specify a future date as the expiration date to a later date to prevent reauthorization of your Hevo Pipeline with GitLab as the Source.

   • Select scopes: The API permissions needed by Hevo to access your data. To grant the required permissions and create the access token, select the following scopes for the API token:

     • api

     • read_api

     • read_user

     • read_repository

     • read_registry

6. Click Create personal access token.

7. Click Copy to copy the access token and save it securely like any other password. Use this token while configuring your Hevo Pipeline.

   

Configuring GitLab as a Source

1. Perform the following steps to configure GitLab as the Source in your Pipeline:

2. Click PIPELINES in the Navigation Bar.

3. Click + CREATE PIPELINE in the Pipelines List View.

4. On the Select Source Type page, select GitLab.

5. On the Configure your GitLab Source page, specify the following:

   

   • Pipeline Name: A unique name for the Pipeline, not exceeding 255 characters.

   • Access token: The access token that you generated in your GitLab account.

6. Click TEST & CONTINUE.

7. Proceed to configuring the data ingestion and setting up the Destination.