Integration Guide

gitlab server logo GitLab Server EE/CE Integration

Introduced in v2.9.4 of the Git add-on, this feature tracks added or deleted repositories from a remote GitLab server (EE/CE) and automatically imports those Git repository references into JIRA.

helpful tip
BigBrassBand recommends a dedicated user for this integration which has access permissions to the GitLab git repositories.

Connecting to a GitLab Server

This process requires an existing GitLab Server EE or GitLab Server CE.

  1. Use the host HTTP/HTTPS URL of your GitLab server to connect the GitLab server to your JIRA server via Git Integration for JIRA add-on.  For example, http://testgitlab.your-org.com.
  2. Click the dropdown arrow on Connect to Git Repository then Connect to GitLab.
  3. Connect to Git dropdown
  4. On the Connect to GitLab screen, select the External service from the dropdown list.  Choose GitLab Server (CE/EE).
  5. Enter the Host URL of the GitLab server.  Enter the username and password credentials for server authentication.
  6. On the following screens, import detected repositories then configure repository settings if required to complete the import process.

The GitLab server is added to the repositories list as a connected server and is automatically reindexed.

Manage repositories of a connected GitLab server via the Git Repositories page under cog Actions  > Show tracked repositories to modify tracked repositories settings.  Enable/disable a tracked repository by checking or unchecking the specific checkboxes.

For more details on GitLab server integration, see Documentation: Connecting to a GitLab Server open in new tab.