Commit 676c8ea3 authored by charlieablett's avatar charlieablett

Upgrade jira user permissions workflow docs

Update screecaps to reflect jira version ~8.1 and update instructions
to include Permission Schemes.
parent 2275c04a
...@@ -12,7 +12,7 @@ It is important that the user `gitlab` has 'write' access to projects in Jira. ...@@ -12,7 +12,7 @@ It is important that the user `gitlab` has 'write' access to projects in Jira.
We have split this stage in steps so it is easier to follow. We have split this stage in steps so it is easier to follow.
1. Log in to your Jira instance as an administrator and under **Administration** 1. Log in to your Jira instance as an administrator and under **Jira Administration**
go to **User Management** to create a new user. go to **User Management** to create a new user.
![Jira user management link](img/jira_user_management_link.png) ![Jira user management link](img/jira_user_management_link.png)
...@@ -27,27 +27,37 @@ We have split this stage in steps so it is easier to follow. ...@@ -27,27 +27,37 @@ We have split this stage in steps so it is easier to follow.
![Jira create new user](img/jira_create_new_user.png) ![Jira create new user](img/jira_create_new_user.png)
1. Create a `gitlab-developers` group which will have write access 1. Create a `gitlab-developers` group which will (eventually) have write access
to projects in Jira. Go to the **Groups** tab and select **Create group**. to projects in Jira. Go to the **Groups** tab and select **Create group**.
![Jira create new user](img/jira_create_new_group.png) ![Jira create new user](img/jira_create_new_group.png)
Give it an optional description and click **Create group**. Give it a name and click **Create group**.
![Jira create new group](img/jira_create_new_group_name.png) 1. Add the `gitlab` user to the `gitlab-developers` group by clicking **Edit members**
The `gitlab-developers` group should be selected on the left hand box. Under **Add members to selected group(s)**,
type in `gitlab`.
1. To give the newly-created group 'write' access, go to ![Jira add user to group](img/jira_add_user_to_group.png)
**Application access > View configuration** and add the `gitlab-developers`
group to Jira Core. Click **Add selected users** and `gitlab` should appear in the middle box. It
is saved automatically.
![Jira added user to group](img/jira_added_user_to_group.png)
1. To give the newly-created group 'write' access, you need to create a **Permission Scheme**.
To do this, click the gear > **Issues**. On the left hand menu, click
**Permission Schemes**. Click **Add Permission Scheme** and fill in a name
and (optional) description.
![Jira add new permission scheme](img/jira_add_permission_scheme.png)
1. Once your permission scheme is created, you'll be taken back to the permissions scheme list.
Locate your new permissions scheme and click **Permissions**. Next to **Administer Projects**,
click **Edit**. In the resulting dialog box, select **Group** and select `gitlab-developers`
from the dropdown.
![Jira group access](img/jira_group_access.png) ![Jira group access](img/jira_group_access.png)
1. Add the `gitlab` user to the `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
intended as part of this process.
![Jira add user to group](img/jira_add_user_to_group.png)
The Jira configuration is complete. Write down the new Jira username and its The Jira configuration is complete. Write down the new Jira username and its
password as they will be needed when [configuring GitLab in the next section](jira.md#configuring-gitlab). password as they will be needed when [configuring GitLab in the next section](jira.md#configuring-gitlab).
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