Jira GitLab integration

Introduction

Integrating Jira with GitLab enables seamless synchronization between project management and version control, enhancing collaboration and workflow efficiency. Follow this comprehensive guide to set up a two-way integration between Jira and GitLab quickly and easily.

Step-by-Step Setup Guide

0. Access the Getint App in Jira

• Navigate to "Apps" and select “Jira - GitLab Integration”

1. Create Integration

• Click "Create integration” or “Migration”

2. Token Generation (Password for Jira Cloud)

• For Jira Cloud, generate a Jira token. This token will act as your password:

  • Go to Atlassian Account Settings.

  • Navigate to Security and generate an API token, then use this token as the password for Jira integration.

3. Choose the Apps and Establish Connections

• Ensure you are logged in as a user with admin rights, click on "Select App" and choose Jira.

• Select "Create New" to establish a new connection with your Jira instance and add the URL of your Jira instance (omit the trailing "/").

• Enter the login credentials of the admin user.

4. Select the Jira Project

• Once the connection is established, choose the Jira project you want to connect to from the dropdown menu.

5. Generate GitLab Token

• Go to the GitLab developer console and generate a token. This token will serve as the password for the integration. Follow the steps here for the token with the correct permissions.

6. Connect to GitLab

• If no connection is established yet, create a new one.

• Use the GitLab token generated as a password.

7. Select the Connection and Project

• Select the established GitLab connection and choose the project you want to integrate with.

8. Type Mapping

• Map the Jira issue types you want to sync with GitLab issues, such as mapping a GitLab issue to a Jira task or a Jira bug to a GitLab issue.

• Consider using the "Quick Build" beta feature for automated type and field mapping, which can streamline the setup process.

9. Field Mapping

• Review or manually map which fields to integrate and sync within the mapped types, including title, description, assignees, custom fields, and more.

10. Assignee Mapping

• Map and match assignees according to your desired configuration.

11. Comments

• If needed, enable the integration and synchronization of comments.

• Filter the comments with the criteria that suit you. Make them private/public or use the preferred attributes such as created date or author.

12. Finalize Integration

• Name your project and click "Create" to finalize the integration setup.

13. Filtering:

It is possible to filter the synchronization to have them customized for your needs and requirements.

UI Filtering Option:

• Click on the filtering icon near the app icon in your integration. This will apply to that side of the integration.

• Select if the filtering applies to All, New, and Synced items.

• Note that if the option “New items” is selected, the filtering will apply only to the new items, and the already synced items will continue to sync and update. If the option “Synced items” is selected, only the already synced items will be updated based on that filter.

• Choose the options and add the value for the filter. It is possible to filter more than one option for each field.

• Select Apply once you created the filters and Save the integration.

Conclusion

Following these steps, you can effectively integrate Jira with GitLab, ensuring smooth synchronization of tasks, issues, and workflows between the two platforms. This setup enhances collaboration and streamlines project management processes.

For further assistance contact our support at [e-mail].