JIRA integration in Crucible
JIRA is Atlassian's issue tracking and project management application.
When Crucible is, you and your team get all the benefits described on this page:
In Crucible, you can:
- See all the Crucible reviews related to a JIRA issue
- Create a Crucible review directly from an issue in JIRA
- Link your Crucible review to a JIRA issue
- Create a JIRA issue from a review comment
- Transition JIRA issues automatically
- Transition JIRA issues from within Crucible
- See issues from multiple instances of JIRA
- See open reviews or unreviewed commits for an entire version within JIRA
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.
Check development progress of a version in JIRA
CRUCIBLE 3.3+ JIRA 6.4+
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.
Was this helpful?
Thanks for your feedback!