GitLab Cloud Integration

The GitLab integration allows Velocity to ingest GitLab's information for monitoring and insights.

Prerequisites

Before you start, our team will provide you with the URIs needed for the setup. To get them, reach out to us in your dedicated Slack channel or email us at [e-mail]

This document describes the Gitlab Cloud integration. If your team has Gitlab on-prem, please contact us through our dedicated Slack channel with your organization or email us at [e-mail].

Overview

This setup includes steps for both you and the Velocity team. We’ve split the process into two parts, with an additional step handled by our team in between.

Step 1 - Configure the GitLab Application

This action must be performed by a user with a Maintainer or Owner role for the projects or groups where Webhooks will be configured.

Once you receive the URIs from the Velocity team, you'll have to configure the Velocity app within their GitLab instance using the Redirect URI provided.

1. Create the Application:

   • Log in to your GitLab instance.

   • Navigate to Preferences by clicking on your avatar and choosing Preferences.

     
   • Click on Applications.

   • Click on New Application.

   • Fill in the necessary details:

     • Name: Provide a name for the application. Make sure to have a descriptive name, such as Velocity Integration.

     • Redirect URI: Use the Redirect URI sent to you by Velocity's team.

   • Enable the following scopes as required by the application:

     • api

     • read_repository

       
   • Save the application.

2. Share needed information with Velocity:

   • After saving, GitLab will provide an Application ID and Secret.

   

   • Send Velocity's team these values via the communication channels mentioned above.

Step 2 - Velocity to Confirm Application Setup

Step 3 - Authorize the Application

Complete this part only after Velocity's team indicated that the application setup has been completed on Velocity's end.

Now that the application is configured, you should authorize the application.

Invoke the Authorize URI:

• Open the email sent to you by Velocity's team (before Step 1).

• Copy the Authorize URI and paste it into your browser to start the authorization process.

• This URI will redirect to GitLab where you'll need to approve the application to access your account.

• Click the "Authorize <App Name>" button:

  

Step 4 - Verify the installation

To verify the installation, go back to the applications screen in Gitlab:

• Log in to GitLab.

• Navigate to Preferences by clicking on your avatar and choosing Preferences.

  
• Click on Applications.

• Under Authorized Applications, you should see the new configured app: