Integrating with Jira

2 minute readExtensibility

CloudBees Feature Management integration with Jira allows teams to connect feature flags to Jira issues for the purposes of flag cleanup. Teams can create Jira tasks that support flag deletion within the CloudBees Feature Management UI. A legacy CloudBees Feature Management integration with Jira also exists that allows teams to gain visibility into feature deployment from within the Jira interface.

Integrating with Jira for flag cleanup

You must be an application administrator to enable Jira to integrate with CloudBees Feature Management, and you must connect CloudBees Feature Management to Jira before creating any Jira tasks for flag cleanup.

The flag cleanup capability allows you to connect Jira issues to feature flags. When connected, Jira issues are displayed in the flag cleanup screen as a recommended task for completion before flag deletion.

Connecting CloudBees Feature Management to Jira

  1. From the CloudBees Feature Management Home page, select the organization to integrate Jira tasks for.

  2. From the top left corner, select All apps, then select the application.

  3. From the left pane, select App settings.

  4. From the top of your screen, select Integrations.

  5. In Jira, select Create.

  6. Go to Atlassian’s Manage API tokens for your Atlassian account page and follow the instructions to create an API token.

  7. Enter your Jira API token details.

    Adding the jira token details.
    Figure 1. Jira token details example
  8. Select Set token.

    Your Jira API token is configured.

Removing Jira integration from CloudBees Feature Management

  1. Select the trash can icon.

    Deleting a Jira API token
    Figure 2. Selecting the trash can icon
  2. Select the Yes, I understand and accept the risks associated with this action checkbox.

  3. Select Yes, Delete.

    Deleting a Jira API token
    Figure 3. Deleting the Jira API token

Your Jira API token is removed, and you will no longer see linked Jira tickets when performing flag cleanup.

(Legacy) Facilitating feature deployment through Jira

You can connect feature flags to Jira issues to gain visibility into feature deployment from within the Jira interface. This functionality is rarely used.

This method of Jira integration is not related to flag cleanup and is rarely used.

To connect Jira to CloudBees Feature Management:

  1. Go to Atlassian’s CloudBees Feature Management app page and follow the instructions to install the CloudBees Feature Management marketplace app.

  2. In your Jira project settings, select CloudBees Feature Management Integration. Then select Connect.

  3. At the CloudBees Feature Management dashboard, confirm the connection, then select Close. You will be redirected back to Jira.

To connect a Jira issue to a feature flag:

  1. In the Jira issue view, select a task. Then select Connect feature flag from the Releases section.

    Connecting a flag
    Figure 4. Example Jira screen with tasks
  2. Choose your application, platform, and the desired feature flag and select Connect.

    Selecting connect
    Figure 5. Connecting a flag to a Jira issue

Your feature flag is now connected to Jira.

Viewing flags and Jira issues in CloudBees Feature Management

In the CloudBees Feature Management overview page, you can view all flags along with any connected Jira issues.

  • View all flags and connected Jira issues

    1. From the CloudBees Feature Management Home screen, select your account profile Account at the top right corner.

    2. From the center of your screen, select the Jira integration tab.

    Jira Integration with flag.
    Figure 6. Flag overview page listing connected Jira issues
  • Select the Jira issue to open Jira at the connected issue.

  • Select the trash can icon to disconnect a Jira issue from a flag.