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

Note: An existing Jira license will be required to achieve this

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

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

    GitLab integration.png
  3. From the header menu select ‘Security'

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

Create and manage API.png
  1. From the API Tokens page select ‘Create API token’

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

  3. 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.

  1. Open your GitLab project

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

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

  1. 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

Need help?

Contact Atlassian Support.

Article feedback

If you’d like to share any feedback about this article, please let us know.

 

Â