Bamboo 3.4 : Linking JIRA Issues to a Build

If your organisation uses the Atlassian's JIRA and your administrator has integrated Bamboo with JIRA, you will be able to view the JIRA issues that have been linked to the build. If you have specified an issue in your build comments, labels or commit messages (note, you must specify the issue key in upper-case), then these issue links are either created automatically by Bamboo. You can also manually add new issue links to your build, or edit or remove any issue links.

Editing Issues Links for your Build

Issue links that have been created automatically or manually, can be edited or removed from the build.

To edit an existing JIRA Issue link for a build result:

  1. Go to the plan in Bamboo.
  2. Click the 'Completed Builds' tab, then click the Build Number for the build that you wish to view.
  3. This will display the Build Result Summary. Click the 'Issues' tab.
  4. All of the JIRA issues linked to your build will display grouped by 'Fixed Issues' and 'Related Issues'. By default, all issue links that are automatically created by Bamboo are created as 'Related Issues'.
    • To change a 'Related Issue' to a 'Fixed Issue', click the up arrow icon .
    • To change a 'Fixed Issue' to a 'Related Issue', click the down arrow icon .
    • To remove an issue link from the build (the issue will not be removed from JIRA), click the trash can icon .

Manually Adding New Issue Links to a Build

If an issue has not been linked automatically to your build, you can manually create a new link from that issue to your build.

To manually add a new JIRA Issue link to a build result:

  1. Go to the plan in Bamboo.
  2. Click the 'Completed Builds' tab, then click the Build Number for the build that you wish to view.
  3. This will display the Build Result Summary. Click the 'Issues' tab.
  4. All of the JIRA issues linked to your build will display. Click the 'Add linked issue' link.
  5. The 'Add Linked JIRA Issue' screen will display (see screenshot below). Select the 'Type of Issue Link', which can be 'Fixed' or 'Related'.
    • 'Fixed' means that this issue is fixed by this build, e.g. a bug.
    • 'Related' means that this issue is related to this build, but not fixed by it, e.g. a documentation task related to changes from the build.
  6. Enter the JIRA issue key of the issue you want to link to this build. Please note, you must specify the issue key in upper-case, e.g. 'JIRA-1234'.
  7. Click 'Save' to link the issue to your build. It will now display on the 'Issues' tab.

Screenshot above: Adding new JIRA Issue Links to a Build

Notes

Related Topics

Viewing the JIRA Issues for a Build Result
Viewing the JIRA Issues linked to the Builds in a Build Plan