1
0
mirror of https://github.com/Unleash/unleash.git synced 2024-12-22 19:07:54 +01:00
unleash.unleash/website/docs/integrations/jira-plugin-installation.md
2021-10-26 11:25:19 +02:00

2.4 KiB

id title
jira_plugin_installation Jira Integration - Installation

The Jira Plugin is part of Unleash Enterprise.

With the Unleash JIRA plugin you can create new feature toggles in Unleash from a JIRA issue. You'll also be able to link existing toggles to JIRA issues as well as see current status of the linked toggle as both a custom field and as an Issue Panel.

Required access levels

Unleash

You will need an Unleash Instance Admin to configure an admin API token.

Jira

You will need a Jira user with access to install plugins.

Installation

The Jira plugin is currently not listed on the Atlassian marketplace.

To get access to the Jira plugin, please reach out to sales@getunleash.io.

You will receive a dedicated link that will allow you to download and install the Unleash Jira plugin.

When following the link you'll be greeted by an installation screen similar to the one down below Jira plugin install

Configuring plugin

Once installed you'll need to head to "Manage your apps"

Jira - app menu bar location Jira - manage your apps link

Once there you should see "Unleash Admin" in your sidebar.

Click it, and you'll get taken to our configuration page

Jira - manage apps sidebar

Once on the configuration page. You should enter your installation URL and an API Key with access level Admin

  • For your installation URL
    • if you're using Unleash Hosted in Europe, your URL will have the format https://app.unleash-hosted.com/**[instanceName]**/api
    • if you're using Unleash Hosted in US, your URL will have the format https://us.unleash-hosted.com/**[instanceName]**/api
    • if you're Self hosted, your URL will need to point to wherever your installation is located, suffixed with /api.
  • See the API token doc for how to configure an Admin token

    NB! Since the plugin is currently using an ADMIN level API token, it has full access to all projects and issues

Jira - Configure unleash app

After you've entered the URL and API key and clicked Submit your api token will no longer be visible.

Jira - API key already set

Now, you're ready to use the plugin from Jira issues