Search…
Gitlab
GitLab is a web-based Git repository that provides free open and private repositories, issue-following capabilities, and wikis.

Prerequisite

In order to get started with embedding your Gitlab repositories in configure8, you must create a new personal API token (PAT). PAT's are unique to your organization. A PAT is required by configure8 to read your branch and pipeline information from Gitlab.You can review the full instructions for creating a personal API token here.

Create a personal access token

You can create as many personal access tokens as you like. Here is how to create an API in Gitlab:
  1. 1.
    Go into your Gitlab application.
  2. 2.
    In the top-right corner, select your avatar.
  3. 3.
    Select Edit profile.
  4. 4.
    On the left sidebar, select Access Tokens.
  5. 5.
    Enter a name and optional expiry date for the token.
  6. 6.
    Select the desired scopes. (See note below)
  7. 7.
    Select Create personal access token.
configure8 only requires "read" access for scopes: read_api, read_user, and read_repository.
Save the personal access token somewhere safe. After you leave the page, you no longer have access to the token.

Creating a Gitlab Credential

To connect your Gitlab account to configure8, perform the following steps.
Start by navigating to the Credentials page by clicking on the "lock" icon on the menu bar.​​
Next, select the Add Credential button.
​​From the Add Credential pop-up, select Gitlab from the list of available providers.​​
Next, enter the information required for your credential.​​
Name: a recognizable alias for the new credential
Personal Access Token: this is the Gitlab Personal Access Token you generated in the prerequisite section above.
Host URL: This defaults to https://gitlab.com for those using Gitlab's SAS implementation.
If you are using the on-premise version of Gitlab, you can enter the URL of your instance. Just make sure your firewall rules will allow the configure8 app to hit that URL from outside your organization. IP's used by configure8 are:
3.134.237.30
18.190.3.63
3.131.181.75
Fetch personal projects on discovery: Your choice
Select Save to create your Gitlab credential in configure8.
The configure8 app will automatically validate the credentials to make sure they work. If they do not, the credentials will not be saved and you will be prompted to fix them.​​

Configuring Gitlab for your Services

Adding a Gitlab plug-in to your service adds the code quality summary to your service overview page. To add a Gitlab plug-in to your service, start by selecting a service from your catalog Services listing.
From your service detail page, select the Add Plug-in button.
From the Plugins dialog, browse through the list of available plugins and select one of the available Gitlab plug-ins by clicking on the Add button.
In the Plug-ins configuration wizard, select an existing credential to connect to the selected plugin provider. If you do not have an existing credential or would like to use a new credential, select the Add Credential button and follow the directions above for install the Gitlab application.
Next, enter the information required for your Gitlab plug-in configuration.
  • Plugin Title: the title of the plug-in to display on the service overview page
Once you have entered all the required configuration information, select Done. Your Gitlab plug-in is added to your service overview page.
If you added the Gitlab pipeline plug-in, you will now see information on the CI/CD tab of the service.
Copyright © 2022 configure8, Inc. All rights reserved.
Last modified 5d ago
Copy link
Outline
Prerequisite
Create a personal access token
Creating a Gitlab Credential
Configuring Gitlab for your Services