Commit 11db9be6 authored by Evan Read's avatar Evan Read

Merge branch 'add-icons-jira-connect-dev-doc' into 'master'

Use `settings` icon in Jira connect dev doc

See merge request gitlab-org/gitlab!47594
parents e1a80495 c052deb9
...@@ -4,34 +4,34 @@ group: Ecosystem ...@@ -4,34 +4,34 @@ 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 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
--- ---
# Setting up a development environment # Set up a development environment
The following are required to install and test the app: The following are required to install and test the app:
1. A Jira Cloud instance - 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).
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). These also take care of SSL for you because Jira requires all connections to the app
host to be over SSL.
1. A GitLab instance available over the internet ## Install the app in Jira
For the app to work, Jira Cloud should be able to connect to the GitLab instance through the internet. To install the app in Jira:
To easily expose your local development environment, you can use tools like 1. Enable Jira development mode to install apps that are not from the Atlassian
[serveo](https://medium.com/automationmaster/how-to-forward-my-local-port-to-public-using-serveo-4979f352a3bf) Marketplace:
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.
## Installing the app in Jira 1. In Jira, navigate to **Jira settings > Apps > Manage apps**.
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. Scroll to the bottom of the **Manage apps** page and click **Settings**. 1. Scroll to the bottom of the **Manage apps** page and click **Settings**.
1. Select **Enable development mode** and click **Apply**. 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. 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. 1. In the **From this URL** field, provide a link to the app descriptor. The host and port must point to your GitLab instance.
......
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