Jira DVCS connector

caution
The Jira DVCS connector for Jira Cloud was deprecated in GitLab 15.1 and removed in 16.0. Use the GitLab for Jira Cloud app instead. The Jira DVCS connector was also deprecated and removed for Jira 8.13 and earlier. You can only use the Jira DVCS connector with Jira Data Center or Jira Server in Jira 8.14 and later. Upgrade your Jira instance to Jira 8.14 or later, and reconfigure the Jira integration in your GitLab instance.

Use the Jira DVCS (distributed version control system) connector if you self-host your Jira instance with Jira Data Center or Jira Server and want to use the Jira development panel.

If you’re on Jira Cloud, migrate to the GitLab for Jira Cloud app. For more information, see Install the GitLab for Jira Cloud app.

Configure the Jira DVCS connector

Prerequisites

  • Your GitLab instance must be accessible by Jira.
  • You must have at least the Maintainer role for the GitLab group.
  • Your network must allow inbound and outbound connections between GitLab and Jira.

Create a GitLab application for DVCS

  • For projects in a single group, you should create a group application.
  • For projects across multiple groups, you should create a separate GitLab user account for Jira integration work only. This account ensures regular maintenance does not affect your integration.
  • If you cannot create a group application or separate user account, you can create instead:

To create a GitLab application for DVCS:

  1. Go to the appropriate Applications section.
  2. In the Name text box, enter a descriptive name for the integration (for example, Jira).
  3. In the Redirect URI text box, enter the generated Redirect URL from linking GitLab accounts.
  4. In Scopes, select api and clear any other checkboxes. The Jira DVCS connector requires a write-enabled api scope to automatically create and manage required webhooks.
  5. Select Submit.
  6. Copy the Application ID and Secret values. You need these values to configure Jira.

Configure Jira for DVCS

To configure Jira for DVCS:

  1. Go to your DVCS account. For Jira Server, select Settings (gear) > Applications > DVCS accounts.
  2. To create a new integration, for Host, select GitLab or GitLab Self-Managed.
  3. For Team or User Account, enter the relative path of a top-level GitLab group that the GitLab user can access.
  4. In the Host URL text box, enter the appropriate URL. Replace <gitlab.example.com> with your GitLab instance domain. Use https://<gitlab.example.com>.
  5. For Client ID, use the Application ID value.
  6. For Client Secret, use the Secret value.
  7. Ensure that all other checkboxes are selected.
  8. To create the DVCS account, select Add, then Continue.

Jira redirects to GitLab where you have to confirm the authorization. GitLab then redirects back to Jira where the synced projects are displayed in the new account. The initial sync takes a few minutes. After the initial sync, it can take up to 60 minutes to refresh.

To connect additional GitLab projects from other GitLab top-level groups or personal namespaces, repeat the previous steps with additional Jira DVCS accounts.

Refresh data imported to Jira

Jira imports commits and branches for GitLab projects every 60 minutes. To refresh the data manually in Jira:

  1. Sign in to your Jira instance as the user you configured the integration with.
  2. Go to Settings (gear) > Applications.
  3. Select DVCS accounts.
  4. In the Last activity column, next to the repository you want to refresh, select Refresh ().