Integration Guide

gitlab server logo GitLab Server EE/CE Integration1 Jira Server

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 Jira 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.
  7. helpful tip
    Currently the Git add-on scans only the repositories visible to the user which is used for scanning.  The repositories which are publicly visible (shared for all members or visible to the member with the admin rights) will not be scanned.  This will be supported in a future release.

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.

helpful tip
The Git Integration for Jira add-on supports v3 and v4 of the GitLab API (in both Jira Cloud and Jira Server).