debian-mirror-gitlab/doc/development/integrations/jira_connect.md

92 lines
3.7 KiB
Markdown
Raw Normal View History

2021-01-29 00:20:46 +05:30
---
2021-10-27 15:23:28 +05:30
stage: Ecosystem
group: Integrations
2021-02-22 17:27:13 +05:30
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/#assignments
2021-01-29 00:20:46 +05:30
---
2019-07-31 22:56:46 +05:30
2021-04-17 20:07:23 +05:30
# Set up a development environment **(FREE)**
2019-07-31 22:56:46 +05:30
2021-01-29 00:20:46 +05:30
The following are required to install and test the app:
2019-07-31 22:56:46 +05:30
2021-01-29 00:20:46 +05:30
- 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
2021-03-08 18:12:59 +05:30
be able to connect to the GitLab instance through the internet. For this we
recommend using Gitpod or a similar cloud development environment. For more
information on using Gitpod with GDK, see the:
2019-07-31 22:56:46 +05:30
2021-03-08 18:12:59 +05:30
- [GDK in Gitpod](https://www.loom.com/share/9c9711d4876a40869b9294eecb24c54d)
video.
2021-06-08 01:23:25 +05:30
- [GDK with Gitpod](https://gitlab.com/gitlab-org/gitlab-development-kit/-/blob/main/doc/howto/gitpod.md)
2021-03-08 18:12:59 +05:30
documentation.
2021-10-27 15:23:28 +05:30
<!-- vale gitlab.Spelling = NO -->
You **must not** use tunneling tools such as Serveo or `ngrok`. These are
2021-03-08 18:12:59 +05:30
security risks, and must not be run on developer laptops.
2021-10-27 15:23:28 +05:30
<!-- vale gitlab.Spelling = YES -->
2021-03-11 19:13:27 +05:30
Jira requires all connections to the app host to be over SSL. If you set up
2021-03-08 18:12:59 +05:30
your own environment, remember to enable SSL and an appropriate certificate.
2019-07-31 22:56:46 +05:30
2021-01-29 00:20:46 +05:30
## Install the app in Jira
2019-07-31 22:56:46 +05:30
2021-01-29 00:20:46 +05:30
To install the app in Jira:
2019-07-31 22:56:46 +05:30
2021-01-29 00:20:46 +05:30
1. Enable Jira development mode to install apps that are not from the Atlassian
Marketplace:
2019-07-31 22:56:46 +05:30
2021-01-29 00:20:46 +05:30
1. In Jira, navigate to **Jira settings > Apps > Manage apps**.
2019-07-31 22:56:46 +05:30
1. Scroll to the bottom of the **Manage apps** page and click **Settings**.
1. Select **Enable development mode** and click **Apply**.
2021-01-29 00:20:46 +05:30
1. Install the app:
2019-07-31 22:56:46 +05:30
2021-01-29 00:20:46 +05:30
1. In Jira, navigate to **Jira settings > Apps > Manage apps**.
2019-07-31 22:56:46 +05:30
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.
For example:
2019-09-30 21:07:59 +05:30
2020-04-22 19:07:51 +05:30
```plaintext
2021-03-08 18:12:59 +05:30
https://xxxx.gitpod.io/-/jira_connect/app_descriptor.json
2019-07-31 22:56:46 +05:30
```
2019-09-30 21:07:59 +05:30
2019-07-31 22:56:46 +05:30
1. Click **Upload**.
2021-11-11 11:23:49 +05:30
If the install was successful, you should see the **GitLab.com for Jira Cloud** app under **Manage apps**.
2019-07-31 22:56:46 +05:30
You can also click **Getting Started** to open the configuration page rendered from your GitLab instance.
_Note that any changes to the app descriptor requires you to uninstall then reinstall the app._
2021-02-22 17:27:13 +05:30
### Troubleshooting
If the app install failed, you might need to delete `jira_connect_installations` from your database.
2021-06-08 01:23:25 +05:30
1. Open the [database console](https://gitlab.com/gitlab-org/gitlab-development-kit/-/blob/main/doc/howto/postgresql.md#access-postgresql).
2021-02-22 17:27:13 +05:30
1. Run `TRUNCATE TABLE jira_connect_installations CASCADE;`.
## Add a namespace
To add a [namespace](../../user/group/index.md#namespaces) to Jira:
1. Make sure you are logged in on your GitLab development instance.
1. On the GitLab app page in Jira, click **Get started**.
1. Open your browser's developer tools and navigate to the **Network** tab.
1. Try to add the namespace in Jira.
1. If the request fails with 401 "not authorized", copy the request as a cURL command
and paste it in your terminal.
![Example Vulnerability](img/copy_curl.png)
1. Go to your development instance (usually at: <http://localhost:3000>), open developer
tools, navigate to the Network tab and reload the page.
1. Copy all cookies from the first request.
![Example Vulnerability](img/copy_cookies.png)
1. Append the cookies to the cURL command in your terminal:
`--cookies "<cookies from the request>"`.
1. Submit the cURL request.
1. If the response is `{"success":true}`, the namespace was added.