Skip to content

Jira integration in GitLab

Instructions

Create an API token from your Atlassian account:

  • Log in to https://id.atlassian.com/manage-profile/security/api-tokens
  • Click Create API token.
  • From the dialog that appears, enter a memorable and concise Label for your token and click Create.
  • Click Copy to clipboard, then paste the token to your script, or elsewhere to save:

1

Note: For security reasons it isn't possible to view the token after closing the creation dialog; if necessary, create a new token.You should store the token securely, just as for any password.

To configure your project:

  1. Go to your project and select Settings > Integrations.
  2. Select Jira.

  3. Select Enable integration.

  4. Select Trigger actions. Your choice determines whether a mention of Jira issue (in a GitLab commit, merge request, or both) creates a cross-link in Jira back to GitLab.

  5. To comment in the Jira issue when a Trigger action is made in GitLab, select Enable comments.
  6. To transition Jira issues when a closing reference is made in GitLab, select Enable Jira transitions.
  7. Provide Jira configuration information:
  8. Web URL: The base URL to the Jira instance web interface you’re linking to this GitLab project, such as https://jira.example.com.
    • Jira API URL: The base URL to the Jira instance API, such as https://jira-api.example.com. Defaults to the Web URL value if not set. - Leave blank if using Jira on Atlassian cloud.
    • Username or Email: For Jira Server, use username. For Jira on Atlassian cloud, use email.
    • Password/API token: Use password for Jira Server or API token for Jira on Atlassian cloud.
  9. To enable users to view Jira issues inside the GitLab project, select Enable Jira issues and enter a Jira project key.
    • You can display issues only from a single Jira project in a given GitLab project.
      • If you enable Jira issues with this setting, all users with access to this GitLab project can view all issues from the specified Jira project.
  10. To enable issue creation for vulnerabilities, select Enable Jira issues creation from vulnerabilities.
  11. Select the Jira issue type. If the dropdown is empty, select refresh and try again.
  12. To verify the Jira connection is working, select Test settings.
  13. Select Save changes.

Your GitLab project can now interact with all Jira projects in your instance and the project now displays a Jira link that opens the Jira project.

  1. Contributors: Buddhi Raj Tuladhar ↩