Commit bf5c72e2 authored by Victor Wu's avatar Victor Wu

Update jira_development_panel.md

parent 5482fd22
...@@ -3,15 +3,21 @@ ...@@ -3,15 +3,21 @@
> [Introduced][ee-2381] in [GitLab Premium][eep] 10.0. > [Introduced][ee-2381] in [GitLab Premium][eep] 10.0.
As an extension to our [existing JIRA][existing-jira] project integration, you're now able to integrate As an extension to our [existing JIRA][existing-jira] project integration, you're now able to integrate
all your GitLab projects with [JIRA Development Panel][jira-development-panel]. Both can be used GitLab projects with [JIRA Development Panel][jira-development-panel]. Both can be used
simultaneously. This works with self-hosted GitLab or GitLab.com integrated with self-hosted JIRA simultaneously. This works with self-hosted GitLab or GitLab.com integrated with self-hosted JIRA
or cloud JIRA. or cloud JIRA.
By doing this you can easily access related GitLab merge requests, branches, and commits directly from a JIRA issue. By doing this you can easily access related GitLab merge requests, branches, and commits directly from a JIRA issue.
This integration connects all GitLab projects a user has access to with all projects in the JIRA instance. This integration connects all GitLab projects within a top-level group or a personal namespace to projects in the JIRA instance.
A top-level GitLab group is one that does not have any parent group itself. All the projects of that top-level group,
as well as projects of the top-level group's subgroups nesting down, are connected. Alternatively, you can configure
a GitLab personal namespace, which will then connect the projects in that personal namespace to JIRA.
(Note this is different from the [existing JIRA][existing-jira] project integration, where the mapping (Note this is different from the [existing JIRA][existing-jira] project integration, where the mapping
is one GitLab project to the entire JIRA instance.) We recommend that a GitLab group admin is one GitLab project to the entire JIRA instance.)
We recommend that a GitLab group admin
or instance admin (in the case of self-hosted GitLab) set up the integration with respect to their or instance admin (in the case of self-hosted GitLab) set up the integration with respect to their
account, in order to maximize the integrated GitLab projects used by your team. account, in order to maximize the integrated GitLab projects used by your team.
...@@ -47,7 +53,8 @@ from the left navigation menu. Click `Link GitHub account` to start creating a n ...@@ -47,7 +53,8 @@ from the left navigation menu. Click `Link GitHub account` to start creating a n
Select GitHub Enterprise for the `Host` field. Select GitHub Enterprise for the `Host` field.
For the `Team or User Account` field, enter the group name of a GitLab group that you have access to. This must be a top-level group, but all its subgroups will be imported. For the `Team or User Account` field, enter the group name of a top-level GitLab group that you have access to,
or the name of your personal namespace.
![Creation of Jira DVCS integration](img/jira_dev_panel_jira_setup_2.png) ![Creation of Jira DVCS integration](img/jira_dev_panel_jira_setup_2.png)
...@@ -74,10 +81,8 @@ from the left navigation menu. Click `Link GitHub account` to start creating a n ...@@ -74,10 +81,8 @@ from the left navigation menu. Click `Link GitHub account` to start creating a n
> ![Refresh GitLab information in JIRA](img/jira_dev_panel_manual_refresh.png) > ![Refresh GitLab information in JIRA](img/jira_dev_panel_manual_refresh.png)
4. Repeat the above steps for each GitLab group's projects that you want to be made known to JIRA. To connect additional GitLab projects from other GitLab top-level groups (or personal namespaces), repeat the above
Specify the GitLab group name accordingly. (Note that you can also specify GitLab user names, as they steps with additional JIRA DVCS accounts.
are really GitLab "groups" behind the scenes. In that case, all the projects for that user would
be made known to JIRA, up to the permissions of the user setting up the integration.)
You can now see the linked `branches`, `commits`, and `merge requests` when entering a JIRA issue. You can now see the linked `branches`, `commits`, and `merge requests` when entering a JIRA issue.
(Inside the Jira issue, merge requests will be called "pull requests"). (Inside the Jira issue, merge requests will be called "pull requests").
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment