summaryrefslogtreecommitdiff
path: root/doc/project_services
diff options
context:
space:
mode:
authorAchilleas Pipinellis <axilleas@axilleas.me>2016-01-25 13:48:36 +0100
committerAchilleas Pipinellis <axilleas@axilleas.me>2016-01-25 13:48:36 +0100
commitd5fc2e9ded87579c588972da5e53f635e4f1d36d (patch)
treeeefdd76a27fb60ddf4015058b4ff4ee0d19a7d1a /doc/project_services
parent5637423c698d373232f70af91e13bd16610510ac (diff)
downloadgitlab-ce-d5fc2e9ded87579c588972da5e53f635e4f1d36d.tar.gz
Add steps on configuring JIRA
[ci skip]
Diffstat (limited to 'doc/project_services')
-rw-r--r--doc/project_services/img/jira_add_user_to_group.pngbin0 -> 59251 bytes
-rw-r--r--doc/project_services/img/jira_create_new_group.pngbin0 -> 41294 bytes
-rw-r--r--doc/project_services/img/jira_create_new_group_name.pngbin0 -> 12535 bytes
-rw-r--r--doc/project_services/img/jira_create_new_user.pngbin0 -> 26532 bytes
-rw-r--r--doc/project_services/img/jira_group_access.pngbin0 -> 46028 bytes
-rw-r--r--doc/project_services/img/jira_user_management_link.pngbin0 -> 58211 bytes
-rw-r--r--doc/project_services/jira.md75
7 files changed, 62 insertions, 13 deletions
diff --git a/doc/project_services/img/jira_add_user_to_group.png b/doc/project_services/img/jira_add_user_to_group.png
new file mode 100644
index 00000000000..e4576433889
--- /dev/null
+++ b/doc/project_services/img/jira_add_user_to_group.png
Binary files differ
diff --git a/doc/project_services/img/jira_create_new_group.png b/doc/project_services/img/jira_create_new_group.png
new file mode 100644
index 00000000000..edaa1326058
--- /dev/null
+++ b/doc/project_services/img/jira_create_new_group.png
Binary files differ
diff --git a/doc/project_services/img/jira_create_new_group_name.png b/doc/project_services/img/jira_create_new_group_name.png
new file mode 100644
index 00000000000..9e518ad7843
--- /dev/null
+++ b/doc/project_services/img/jira_create_new_group_name.png
Binary files differ
diff --git a/doc/project_services/img/jira_create_new_user.png b/doc/project_services/img/jira_create_new_user.png
new file mode 100644
index 00000000000..57e433dd818
--- /dev/null
+++ b/doc/project_services/img/jira_create_new_user.png
Binary files differ
diff --git a/doc/project_services/img/jira_group_access.png b/doc/project_services/img/jira_group_access.png
new file mode 100644
index 00000000000..47716ca6d0e
--- /dev/null
+++ b/doc/project_services/img/jira_group_access.png
Binary files differ
diff --git a/doc/project_services/img/jira_user_management_link.png b/doc/project_services/img/jira_user_management_link.png
new file mode 100644
index 00000000000..2745916972c
--- /dev/null
+++ b/doc/project_services/img/jira_user_management_link.png
Binary files differ
diff --git a/doc/project_services/jira.md b/doc/project_services/jira.md
index 3e0129bfe37..65d850934bb 100644
--- a/doc/project_services/jira.md
+++ b/doc/project_services/jira.md
@@ -1,15 +1,15 @@
# GitLab JIRA integration
-GitLab can be configured to interact with JIRA. Configuration happens via
+GitLab can be configured to interact with [JIRA]. Configuration happens via
username and password. Connecting to a JIRA server via CAS is not possible.
-Each project can be configured to connect to a different JIRA instance, see the
-[configuration](#configuration) section. If you have one JIRA instance you can
-pre-fill the settings page with a default template. To configure the template
-see the [Services Templates][services-templates] document.
+Each project can be configured to connect to a different JIRA instance or, in
+case you have one JIRA instance, you can pre-fill the JIRA service settings page
+with a default template. To configure the template, see the
+[Services Templates documentation][services-templates].
Once the project is connected to JIRA, you can reference and close the issues
-in JIRA directly from GitLab.
+in JIRA directly from GitLab's Merge requests.
## Configuration
@@ -20,14 +20,62 @@ The configuration consists of two parts:
### Configuring JIRA
-We need to create a user in JIRA which will have access to all projects that
-need to integrate with GitLab. Login to your JIRA instance as admin and under
-Administration go to User Management and create a new user.
+First things first, we need to create a user in JIRA which will have access to
+all projects that need to integrate with GitLab.
-As an example, we'll create a user named `gitlab` and add it to `jira-developers`
-group.
+We have split this stage in steps so it could be easier to follow.
-**It is important that the user `gitlab` has write-access to projects in JIRA**
+---
+
+1. Login to your JIRA instance as an administrator and under **Administration**
+ go to **User Management** and create a new user.
+
+ ![JIRA user management link](img/jira_user_management_link.png)
+
+ ---
+
+1. The next step is to create a new user (e.g., `gitlab`) who has write-access
+ to projects in JIRA. Enter the user's name and a valid e-mail address in
+ order to set-up their password.
+ _**Note:** JIRA creates the username automatically by using the e-mail
+ prefix. You can change the username later if you want._
+
+ ![JIRA create new user](img/jira_create_new_user.png)
+
+ ---
+
+1. Now, let's create a `gitlab-developers` group which will have write-access
+ to projects in JIRA. Go to the **Groups** tab and select **Create group**.
+
+ ![JIRA create new user](img/jira_create_new_group.png)
+
+ ---
+
+ Give it an optional description and hit **Create group**.
+
+ ![JIRA create new group](img/jira_create_new_group_name.png)
+
+ ---
+
+1. Give the newly-created group write access by going to
+ **Application access > View configuration** and adding the `gitlab-developers`
+ group to JIRA Core.
+
+ ![JIRA group access](img/jira_group_access.png)
+
+ ---
+
+1. Add the `gitlab` user to `gitlab-developers` group by going to
+ **Users > GitLab user > Add group** and selecting the `gitlab-developers`
+ group from the dropdown menu. Notice that the group says _Access_ which is
+ what we aim for.
+
+ ![JIRA add user to group](img/jira_add_user_to_group.png)
+
+---
+
+The JIRA configuration is over. Note the new user `gitlab` and its password as
+they will be needed when configuring GitLab in the next section.
### Configuring GitLab
@@ -119,4 +167,5 @@ with a link to the commit that resolved the issue.
---
-[services-templates]: ../project_services/services_templates.md
+[services-templates]: ../project_services/services_templates.md "Services templates documentation"
+[JIRA]: https://www.atlassian.com/software/jira/core "The JIRA Core website"