summaryrefslogtreecommitdiff
path: root/doc/development/integrations/jira_connect.md
diff options
context:
space:
mode:
authorGitLab Bot <gitlab-bot@gitlab.com>2020-11-19 08:27:35 +0000
committerGitLab Bot <gitlab-bot@gitlab.com>2020-11-19 08:27:35 +0000
commit7e9c479f7de77702622631cff2628a9c8dcbc627 (patch)
treec8f718a08e110ad7e1894510980d2155a6549197 /doc/development/integrations/jira_connect.md
parente852b0ae16db4052c1c567d9efa4facc81146e88 (diff)
downloadgitlab-ce-7e9c479f7de77702622631cff2628a9c8dcbc627.tar.gz
Add latest changes from gitlab-org/gitlab@13-6-stable-eev13.6.0-rc42
Diffstat (limited to 'doc/development/integrations/jira_connect.md')
-rw-r--r--doc/development/integrations/jira_connect.md38
1 files changed, 22 insertions, 16 deletions
diff --git a/doc/development/integrations/jira_connect.md b/doc/development/integrations/jira_connect.md
index 1f9b03075f0..66a93f8c947 100644
--- a/doc/development/integrations/jira_connect.md
+++ b/doc/development/integrations/jira_connect.md
@@ -1,31 +1,37 @@
-# Setting up a development environment
+---
+stage: Create
+group: Ecosystem
+info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#designated-technical-writers
+---
-The following are required to install and test the app:
-
-1. A Jira Cloud instance
+# Set up a development environment
- Atlassian provides free instances for development and testing. [Click here to sign up](https://developer.atlassian.com/platform/marketplace/getting-started/#free-developer-instances-to-build-and-test-your-app).
+The following are required to install and test the app:
-1. A GitLab instance available over the internet
+- A Jira Cloud instance. Atlassian provides [free instances for development and testing](https://developer.atlassian.com/platform/marketplace/getting-started/#free-developer-instances-to-build-and-test-your-app).
+- A GitLab instance available over the internet. For the app to work, Jira Cloud should
+ be able to connect to the GitLab instance through the internet. To easily expose your
+ local development environment, you can use tools like:
+ - [serveo](https://medium.com/automationmaster/how-to-forward-my-local-port-to-public-using-serveo-4979f352a3bf)
+ - [ngrok](https://ngrok.com).
- For the app to work, Jira Cloud should be able to connect to the GitLab instance through the internet.
+ These also take care of SSL for you because Jira requires all connections to the app
+ host to be over SSL.
- To easily expose your local development environment, you can use tools like
- [serveo](https://medium.com/automationmaster/how-to-forward-my-local-port-to-public-using-serveo-4979f352a3bf)
- or [ngrok](https://ngrok.com). These also take care of SSL for you because Jira
- requires all connections to the app host to be over SSL.
+## Install the app in Jira
-## Installing the app in Jira
+To install the app in Jira:
-1. Enable Jira development mode to install apps that are not from the Atlassian Marketplace
+1. Enable Jira development mode to install apps that are not from the Atlassian
+ Marketplace:
- 1. Navigate to **Jira settings** (cog icon) > **Apps** > **Manage apps**.
+ 1. In Jira, navigate to **Jira settings > Apps > Manage apps**.
1. Scroll to the bottom of the **Manage apps** page and click **Settings**.
1. Select **Enable development mode** and click **Apply**.
-1. Install the app
+1. Install the app:
- 1. Navigate to Jira, then choose **Jira settings** (cog icon) > **Apps** > **Manage apps**.
+ 1. In Jira, navigate to **Jira settings > Apps > Manage apps**.
1. Click **Upload app**.
1. In the **From this URL** field, provide a link to the app descriptor. The host and port must point to your GitLab instance.