GitLab self-managed

As an alternative to using the cloud-based version of GitLab, OpsLevel supports integrating with your GitLab self-managed instance to unlock the same functionality we provide through our other git integrations.

OpsLevel supports two methods to authenticate our GitLab integration:

• OAuth Application
• Personal Access Tokens

Authenticating with an OAuth Application

Set up an application in GitLab

In order to integrate with OpsLevel, an administrator on your GitLab instance will need to configure an application which will allow OpsLevel to communicate with GitLab. Please refer to the instance-wide applications section for your version of GitLab for more information. Below is the typical setup of an application, alongside the OpsLevel specific values required by the application:

📘

Note : OpsLevel supports repository integrations with GitLab versions 14.3+

1. Enter OpsLevel for the application name.
2. Enter https://app.opslevel.com/integrations/gitlab/finish_setup for the Redirect URI.
3. OpsLevel uses several scopes to setup webhooks for your projects and query repository information. Enable these scopes:
   1. api
   2. read_user
   3. read_api
   4. read_repository
   5. write_repository

4. After creating the application you should take note of the Application ID and Secret. You will need these fields when setting up the integration in OpsLevel.

Add a GitLab self-managed integration in OpsLevel

Once the GitLab application has been configured, you will be able to integrate your OpsLevel account with your GitLab self-managed instance by:

1. In the OpsLevel app, clicking Integrations in the left sidebar.
2. Clicking on the + New Integration button.
3. Clicking the GitLab self-managed integration card.
4. In the modal, entering the Application ID and Secret from the application that was created in GitLab and entering the publicly routable URL to your GitLab self-managed instance for the Base URL.

5. Clicking Integrate with GitLab

Integrating Multiple Groups: If you have already integrated a group for your GitLab self-managed instance and want to integrate another one, follow the steps above to add the integration in OpsLevel. We will prefill the fields in the install modal, so you will just need to click Integrate with GitLab and select the group you want to integrate.

Authenticating with a Personal Access Token

Set up a Personal Access Token in GitLab

In order to integrate with OpsLevel using a Personal Access Token, you'll need to configure a Personal Access Token within GitLab

📘

Note : OpsLevel supports repository integrations with GitLab versions 14.3+

1. Enter a name for your Personal Access Token, such as "OpsLevel PAT" (Please note that the name of the PAT is going to be used when configuring the integration in OpsLevel as well.
2. OpsLevel uses several scopes to setup webhooks for your projects and query repository information. Enable these scopes:
   1. api
   2. read_user
   3. read_api
   4. read_repository
   5. write_repository

Add a GitLab self-managed integration in OpsLevel

Once you have the PAT from GitLab, you will be able to integrate your OpsLevel account with your GitLab self-managed instance by:

1. In the OpsLevel app, clicking Integrations in the left sidebar.
2. Clicking on the + New Integration button.
3. Clicking the GitLab self-managed integration card.
4. In the modal, entering the Token Name and Access Token from the PAT that was created in GitLab and entering the publicly routable URL to your GitLab self-managed instance for the Base URL.

5. Clicking Integrate with GitLab

Integrating Multiple Groups: If you have already integrated a group for your GitLab self-managed instance and want to integrate another one, follow the steps above to add the integration in OpsLevel. We will prefill the fields in the install modal, so you will just need to click Integrate with GitLab and select the group you want to integrate.

If you have any questions or feedback, let us know at [email protected].