Commit a44603ed authored by Mario de la Ossa's avatar Mario de la Ossa

Jira DVCS docs - Call out differences between 11.3 and before

parent 0663f7a7
...@@ -21,6 +21,19 @@ We recommend that a GitLab group admin ...@@ -21,6 +21,19 @@ 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.
## Requirements
### Self-hosted GitLab
If you are using self-hosted GitLab, make sure your GitLab instance is accessible by JIRA.
- If you are connecting to JIRA Cloud, make sure your instance is accessible via the internet.
- If you are using JIRA Server, make sure your instance is accessible however your network is set up.
### GitLab.com
There are no special requirements if you are using GitLab.com
## GitLab Configuration ## GitLab Configuration
1. In GitLab, create a new application in order to allow JIRA to connect with your GitLab account 1. In GitLab, create a new application in order to allow JIRA to connect with your GitLab account
...@@ -35,6 +48,9 @@ account, in order to maximize the integrated GitLab projects used by your team. ...@@ -35,6 +48,9 @@ account, in order to maximize the integrated GitLab projects used by your team.
replacing `<your-gitlab-instance-domain>` appropriately. So for example, if you are using GitLab.com, replacing `<your-gitlab-instance-domain>` appropriately. So for example, if you are using GitLab.com,
this would be `https://gitlab.com/login/oauth/callback`. this would be `https://gitlab.com/login/oauth/callback`.
NOTE: **Note**:
If using a GitLab version earlier than 11.3 the `Redirect URI` value should be `https://<your-gitlab-instance-domain>/-/jira/login/oauth/callback`.
![GitLab Application setup](img/jira_dev_panel_gl_setup_1.png) ![GitLab Application setup](img/jira_dev_panel_gl_setup_1.png)
- Check `api` in the Scopes section. - Check `api` in the Scopes section.
...@@ -62,6 +78,9 @@ from the left navigation menu. Click `Link GitHub account` to start creating a n ...@@ -62,6 +78,9 @@ from the left navigation menu. Click `Link GitHub account` to start creating a n
replacing `<your-gitlab-instance-domain>` appropriately. So for example, if you are using GitLab.com, replacing `<your-gitlab-instance-domain>` appropriately. So for example, if you are using GitLab.com,
this would be `https://gitlab.com/`. this would be `https://gitlab.com/`.
NOTE: **Note**:
If using a GitLab version earlier than 11.3 the `Host URL` value should be `https://<your-gitlab-instance-domain>/-/jira`
For the `Client ID` field, use the `Application ID` value from the previous section. For the `Client ID` field, use the `Application ID` value from the previous section.
For the `Client Secret` field, use the `Secret` value from the previous section. For the `Client Secret` field, use the `Secret` value from the previous section.
......
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