LaunchDarkly's Jira add-on allows you to link your feature flags with your team's Jira issues. When a feature flag is turned on, off, or has its targeting rules updated, its associated Jira issue pages will display the flag's current status.
The LaunchDarkly for Jira app into your Jira Cloud instance via the Atlassian Marketplace
The Jira app makes use of LaunchDarkly webhooks to send feature flag updates to your Jira instance. Once the app is installed, you'll need to create a personal API access token with create and delete access to webhooks. This can be done by either creating a token with "Writer" level access or above, or by using a custom role .
If you're using a custom role, a valid configuration would look like this:
Now that you've created an access token, use it to configure the Jira integration for your LaunchDarkly account. Visit your Jira instance's add-on management page, and click the "Configuration" button for the LaunchDarkly app.
From that page, you should first set your API key. Again, create this key with Writer level access, Admin level access, or with a custom role. Then you can select which environment the app will track for each of your LaunchDarkly projects. By default, the app will track your production environments:
If selected environments are reconfigured after issues have already been associated with flags, the existing connections will display the environments they were historically connected to until the next time that flag is updated. New flag connections will display the flag configuration for the updated environment.
Once the LaunchDarkly for Jira App is set up, you should see a "Releases" panel when viewing your issues through the "Active sprints" board. If no flags are currently associated with an existing Jira issue, you'll see a button to add one. If you already have one or more flags associated with a Jira issue, you'll see the rollout status of each connected feature flag on each Jira issue.
Now that the Jira app is configured and ready to rock, it's time to start link our feature flags to our Jira issues.
Releases panel must be enabled
The Jira issue view, which contains the release panel, is a per-user setting. If it is off you will not see the release panel. You can reference this in Jira's documentation here.
To create a new flag with Jira issues, navigate to your Jira issue's feature flag panel, click "Add feature flag", and select the "Create feature flag" option:
You'll then be redirect to the LaunchDarkly flag creation page, where your selected Jira issue will be automatically pre-populated:
If you're ahead of the game and already created a feature flag for your Jira issue, you can add a Jira issue to your existing flag by creating a custom property for your flag of type "Jira issues", and entering a list of Jira issue keys as the property value:
Adding issues to an existing flag
Your Jira issue must exist before you associate it with your feature flag. If you accidentally added a Jira issue to your flag, delete the custom property, create your Jira issue, and try again.