Integration Guide

gitlab server logo GitLab Server EE/CE Integration1 Jira Cloud

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 Cloud

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

  1. On the Jira On-Demand dashboard menu, go to Git > Manage Git Repositories.
  2. The git configuration page for connecting repositories is displayed.
  3. On the Auto-connect integration panel, click GitLab.
  4. git for jira cloud auto-connect panel - select gitlab
  5. On the Connect to GitLab screen, select the External service from the dropdown list.  Choose GitLab Server (CE/EE).
  6. Enter the Host URL of the GitLab server.  Enter the username and password credentials for server authentication.
  7. On the following screens, import detected repositories then configure repository settings if required to complete the import process.
  8. 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.

Repositories added or removed from GitLab server will be likewise added or removed from Jira Cloud.

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