JIRA integration in Crucible

Note that your Crucible and JIRA instances must be linked to make use of these JIRA integration features. See Linking Crucible to JIRA.

 The Crucible project requires a linked JIRA project before issues can be linked to reviews. 

The Release Hub in JIRA shows the relevant issues and development information for a version – so you can determine which issues are likely to ship at a glance. With JIRA and Stash connected, the release page can warn you about open reviews or unreviewed commits that could cause problems for your release.

From the Release Hub you can also:

• Release a version
• Mark a version as complete
• Move incomplete issues to other versions
• Trigger release builds (if JIRA is connected to Bamboo)
• Warnings that help you reconcile what is happening in development with JIRA data.

To view the Release Hub (with the project sidebar enabled), navigate to a project, click on Releases, then select a version listed. See Checking the progress of a version more detailed information about using the Release Hub in JIRA.

See all the Crucible reviews related to a JIRA issue

In a JIRA issue, the Development panel shows the number of reviews that are linked to the issue. Click the reviews link to see details of those reviews.

Link your Crucible review to a JIRA issue

When creating, or editing, your review, Crucible will suggest a JIRA issue that can be linked to the review, if a JIRA issue key is found in the review title. You can:

• click the suggested JIRA issue key, to link it to the review
• delete the suggested JIRA issue and specify a different issue key and click Link to save it.

Create a JIRA issue from a review comment

When viewing any review comment (genaral, file, inline), you can click Create Issue in the comment to create a JIRA issue. Crucible suggests the JIRA instance, project and issue type, but you can modify these. This requires JIRA 5.0, or later, and is disabled if Crucible is integrated with an earlier version of JIRA.

See Creating JIRA issues from the review for more details.

Transition JIRA issues automatically

Your JIRA workflow can now respond to events in your linked development tools, for when a review is started, your JIRA workflow can be configured to automatically transition the related issue. Configure this from transitions within the JIRA workflow editor. (Available with JIRA 6.3.3 and later.)

The events available in Crucible are:

• Review started
• Submitted for approval
• Review rejected
• Review abandoned
• Review closed
• Review summarized

Transition JIRA issues from within Crucible manually

For Crucible reviews that have linked JIRA issues, you can advance the JIRA workflow for the issue from within Crucible. You can do this at any time by clicking the linked issue, or when you close the review:

See Transitioning JIRA issues for more details.

See issues from multiple instances of JIRA

Crucible can link to more than one JIRA server at a time, so different teams can work with their own projects in different JIRA instances, or a single team can link to issues across multiple JIRA servers.