diff options
Diffstat (limited to 'doc/integration/jira/index.md')
| -rw-r--r-- | doc/integration/jira/index.md | 42 |
1 files changed, 27 insertions, 15 deletions
diff --git a/doc/integration/jira/index.md b/doc/integration/jira/index.md index 2646a6c5e2e..a85ffdd1feb 100644 --- a/doc/integration/jira/index.md +++ b/doc/integration/jira/index.md @@ -7,28 +7,28 @@ info: To determine the technical writer assigned to the Stage/Group associated w # Jira integrations **(FREE)** If your organization uses [Jira](https://www.atlassian.com/software/jira) issues, -you can [migrate](../../user/project/import/jira.md) your issues from Jira and work +you can [migrate your issues from Jira](../../user/project/import/jira.md) **(PREMIUM)** and work exclusively in GitLab. However, if you'd like to continue to use Jira, you can integrate it with GitLab. GitLab offers two types of Jira integrations, and you -can use one or both depending on the capabilities you need. +can use one or both depending on the capabilities you need. It is recommended that you enable both. -## Compare Jira integrations +## Compare integrations After you set up one or both of these integrations, you can cross-reference activity in your GitLab project with any of your projects in Jira. -<i class="fa fa-youtube-play youtube" aria-hidden="true"></i> -For an overview, see [Agile Management - GitLab-Jira Basic Integration](https://www.youtube.com/watch?v=fWvwkx5_00E&feature=youtu.be). +### Jira integration -### Per-project Jira integration +This integration connects one or more GitLab project to a Jira instance. The Jira instance +can be hosted by you or in [Atlassian cloud](https://www.atlassian.com/cloud). +The supported Jira versions are `v6.x`, `v7.x`, and `v8.x`. -This integration connects a single GitLab project to a Jira instance. The Jira instance -can be hosted by you or in [Atlassian cloud](https://www.atlassian.com/cloud): +<i class="fa fa-youtube-play youtube" aria-hidden="true"></i> +For an overview, see [Agile Management - GitLab-Jira Basic Integration](https://www.youtube.com/watch?v=fWvwkx5_00E&feature=youtu.be). -- *If your installation uses Jira Cloud,* use the - [GitLab for Jira app](connect-app.md). -- *If either your Jira or GitLab installation is self-managed,* use the - [Jira DVCS Connector](dvcs.md). +To set up the integration, [configure the project settings](development_panel.md#configure-gitlab) in GitLab. +You can also configure these settings at a [group level](../../user/admin_area/settings/project_integration_management.md#manage-group-level-default-settings-for-a-project-integration), +and for self-managed GitLab, at an [instance level](../../user/admin_area/settings/project_integration_management.md#manage-instance-level-default-settings-for-a-project-integration). ### Jira development panel integration @@ -37,6 +37,13 @@ connects all GitLab projects under a group or personal namespace. When configure relevant GitLab information, including related branches, commits, and merge requests, displays in the [development panel](https://support.atlassian.com/jira-software-cloud/docs/view-development-information-for-an-issue/). +To set up the Jira development panel integration: + +- *If your installation uses Jira Cloud,* use the + [GitLab for Jira app](connect-app.md). +- *If either your Jira or GitLab installation is self-managed,* use the + [Jira DVCS Connector](dvcs.md). + ### Direct feature comparison | Capability | Jira integration | Jira Development panel integration | @@ -48,7 +55,7 @@ displays in the [development panel](https://support.atlassian.com/jira-software- | Add Jira time tracking to an issue. | No. | Yes. Time can be specified using Jira Smart Commits. | | Use a Git commit or merge request to transition or close a Jira issue. | Yes. Only a single transition type, typically configured to close the issue by setting it to Done. | Yes. Transition to any state using Jira Smart Commits. | | Display a list of Jira issues. | Yes. **(PREMIUM)** | No. | -| Create a Jira issue from a vulnerability or finding. **(ULTIMATE)** | Yes. | No. | +| Create a Jira issue from a vulnerability or finding. | Yes. **(ULTIMATE)** | No. | ## Authentication in Jira @@ -64,10 +71,10 @@ The process for configuring Jira depends on whether you host Jira on your own se ## Privacy considerations -If you integrate a private GitLab project with Jira using the [**Per-project Jira integration**](#per-project-jira-integration), +If you integrate a private GitLab project with Jira using the [**Jira integration**](#jira-integration), actions in GitLab issues and merge requests linked to a Jira issue leak information about the private project to non-administrator Jira users. If your installation uses Jira Cloud, -you can use the [GitLab for Jira app](connect-app.md) to avoid this risk. +you can use the [GitLab.com for Jira Cloud app](connect-app.md) to avoid this risk. ## Troubleshooting @@ -96,3 +103,8 @@ which may lead to a `401 unauthorized` error when testing your Jira integration. If CAPTCHA has been triggered, you can't use Jira's REST API to authenticate with the Jira site. You need to log in to your Jira instance and complete the CAPTCHA. + +## Third-party Jira integrations + +Developers have built several third-party Jira integrations for GitLab that are +listed on the [Atlassian Marketplace](https://marketplace.atlassian.com/search?product=jira&query=gitlab). |