Integrate GitLab with Jira

This article will show you how to integrate your GitLab project with the University of Waterloo Jira instance. The benefits of this integration include navigating to Jira issues quickly from GitLab, detecting and linking to Jira issues from GitLab commits and merge requests, logging GitLab events in the associated Jira issue, and automatically transitioning Jira issues with GitLab commits and merge requests. For more information visit the GitLab support documentation.

1. Log into Jira using your UWaterloo account

2. In Jira select your initials in the top right of the page.

3. A menu will appear, select ‘manage account’

   Open

   

4. From the header menu select ‘Security'

5. On the security page, select ‘Create and manage API tokens’

Open

6. From the API Tokens page select ‘Create API token’

7. Provide a label for the API token and select ‘Create’

8. An API token will be generated, select ‘Copy’ and then select ‘Close’

   1. You will not be able to view the key in the future so ensure you have this copied before closing.

9. Open your GitLab project

10. Select the project ‘Settings’ and then select ‘Integrations’

11. From the integrations list find ‘Jira’ and select ‘Configure’

12. Make the following adjustments to the configuration settings, and select ‘Save’

    1. Enable integrations - Active

    2. Web URL - https://uwaterloo.atlassian.net

    3. Authentication method - Basic

       1. Email or username - WatIAM@uwaterloo.ca

       2. New API token or passcode - Insert the API token you copied from Atlassian

    4. Trigger, Issues - choose your desired configuration

       1. This determines whether mentioning a Jira issue in GitLab commits, merge requests, or both, should link the Jira issue back to that source commit/MR and transition the Jira issue, if indicated.

Related articles