Home

This plugin provides an easy way to link Jira issues with GitLab items via remote issue links:

These links are rendered with additional information retrieved via GitLab's REST API:

The following types of GitLab links are supported:

• Projects
• Commits
• Tags
• Issues
• Merge Requests
• Milestones
• Releases
• Files
• Folders

If the Jira user has no permission to access the GitLab resources or the plugin's requirements are not met then simple GitLab links are rendered instead:

Requirements

The plugin uses the username of the currently authenticated Jira user to access GitLab's REST API in sudo mode. So for rendering GitLab links with additional data provided by the GitLab server the following requirements need to be met:

• The users have the same username in Jira and GitLab.
• A personal access token - with sudo permission - from a GitLab system administrator is required.

If these requirements are not met then simple GitLab links (without the information provided by the GitLab Server) are rendered.

Installation

Open Jira's plugin manager and upload the jar from the latest release of this plugin.

Configuration

Open Jira's Administration Console, switch to the Applications tab and select the item GitLab Links from the Integrationssection. Here the GitLab server URL and a personal access token (with sudo permission) from a GitLab system administrator are specified.

If the personal access token is omitted then simple GitLab links (without the information provided by the GitLab Server) are rendered.