Sync GitLab Plugin

Overview

The Sync GitLab Plugin is an Atlassian Forge plugin designed to synchronize Jira issues with GitLab issues. It provides fine granularity export of Jira issues and automatic synchronization of issue changes.

Features

1. Fine Granularity Export

Export Jira issues with fine granularity using one of the following methods:

  • By Project: Export all issues within a specific Jira project.
  • By JQL Search: Export issues based on a Jira Query Language (JQL) search query.
  • By Predefined Filter: Export issues using predefined Jira filters.

2. Automatic Synchronization

Automatically synchronize changes made to Jira issues with their corresponding GitLab issues. This includes updates to the issue status, description, comments, and other relevant fields.

Installation

To install the Sync GitLab Plugin, follow these steps:

  1. Navigate to the Atlassian Marketplace.
  2. Search for "Sync GitLab Plugin".
  3. Click "Install" to add the plugin to your Jira instance.
  4. Configure the plugin settings as described in the configuration section.

Configuration

After installation, configure the plugin to start synchronizing Jira issues with GitLab issues:

  1. Go to the plugin settings page in your Jira instance.
  2. Provide your GitLab instance URL, GitLab username, and private token obtained from GitLab. The procedure is described here.
  3. Save the configuration.

Usage

Issue exporting is available from the project page. In order to get to plugin please follow this steps: pick your project from the Projects menu. Then from the sidebar click Back to project. In the new page click Sync GitLab - Export issues to GitLab in the left sidebar under the APPS entry.

The first step to export issues to GitLab is to pick the exact issues that you wish to export. In the JQL Search you need to input a JQL query that will return the issues that you might want to export. The Export fields field should contain the fields that you wish exported for each issue.

Once you click Search a table of issues is shown together with their associated fields. From this table you can either:

Clicking Proceed to export to GitLab will show a last window in which you need to pick a GitLab project onto which to export the issues.

Clicking Export will start the exporting process. Note that this process might take some time depending on the number of issues to export. At the end of the exporting a confirmation message should appear of form: Successfuly exported issues to GitLab.

Support

If you encounter any issues or need assistance, please contact our support team.