Integrating Bamboo with JIRA

Integrating Bamboo with Atlassian's JIRA combines Bamboo's continuous integration capabilities with your issue tracker to give you a unified view of your software development project.

Using JIRA and Bamboo together, you can:

create actionable JIRA issues from a Bamboo build
run a Bamboo build when releasing a JIRA version
have Bamboo automatically link a plan branch with a JIRA issue
view the JIRA issues linked to a build result
view the Bamboo builds that relate to a particular JIRA issue
view the Bamboo builds that relate to a JIRA project or version
add Bamboo gadgets to a JIRA dashboard.

Configuring Bamboo and JIRA to work together simply requires you to set up an application link (two-way) between JIRA and Bamboo. By the way, application links have nothing to do with using JIRA as a user repository for Bamboo; these 2 configurations can exist separately.

On this page:

Related pages:

Configuring Application Links (JIRA documentation)

Before you begin

Version Requirements

Application	Requirement	Notes
Bamboo	Version 3.1 or later	If you are using an earlier version of Bamboo, please refer to these instructions in the corresponding older version of the Bamboo documentation.
JIRA	Version 4.4 or later	If you are using an earlier version of JIRA, please refer to the Bamboo 3.0 instructions: Integrating Bamboo with JIRA (Bamboo 3.0).

If you are using an earlier version of Bamboo and/or JIRA, you can also download an older version of the JIRA Bamboo plugin from the Atlassian Plugin Exchange. However, we strongly advise you to upgrade JIRA to version 4.4 or later and Bamboo to version 3.1 or later, if you wish to integrate Bamboo with JIRA.

Set up an application link

Before you begin:

Security Considerations — The instructions below recommend setting up authentication for the application link between JIRA and Bamboo. Please ensure that you read the Security Implications for each Authentication Type (JIRA documentation). For example, if you use basic HTTP authentication for the JIRA to Bamboo link, you must specify a user that JIRA uses to log in to Bamboo. Hence, this user's Bamboo permissions will be used (not the Bamboo permissions of the user who is currently logged into JIRA), e.g. a user viewing Bamboo information in JIRA will see all builds available to the user specified in the JIRA-Bamboo setup, instead of the builds available under their own permissions.

Follow the JIRA instructions to configure the application link in JIRA.

You will need to set up a two-way link, i.e. select the 'Create a link back to this server' option when adding the application link.
You will need to configure either OAuth or Trusted Apps authentication for your application link. See Configuring Authentication for an Application Link for instructions.

Note that if you are running Bamboo behind a proxy, you may need to configure the AJP connector.

Congratulations! You have successfully integrated Bamboo and JIRA.

Try your new configuration

You may wish to read about how to use these two applications together in the following pages:

View the Bamboo builds that relate to a particular JIRA issue. If you are able to see your JIRA issues from a Bamboo build, but cannot see your Bamboo builds in JIRA (on the Builds tab), please make sure that you have "View Version Control" permission enabled.
View the Bamboo builds that relate to a JIRA project or version.
View the JIRA issues for a build result.
Add JIRA gadgets to display the status of your builds or a graphical summary of each build plan (please note, if you have added multiple Bamboo servers there will be one set of these Bamboo gadgets available for each server, e.g. 'Bamboo Status Gadget from http://172.20.5.83:8085').
Trigger Bamboo builds when releasing JIRA versions (JIRA documentation).

Notes

What if the Bamboo gadgets do not appear in JIRA?

If the Bamboo gadgets do not appear in your JIRA gadget directory, you will need to subscribe to Bamboo's gadgets in JIRA.

To subscribe to Bamboo's gadgets in JIRA:

Go to your JIRA dashboard.
Click Add Gadget.
In the 'Gadget Directory' dialog, click Gadget Subscriptions.
In the 'Gadget Subscriptions' dialog, click Add Subscription.
In the 'Add Subscriptions' dialog, copy the base URL for your Bamboo site (e.g. http://www.foobar.com:8085) and paste it into the text box on the screen.
Click Add Subscription.
Click Finished.

Known issues

Deploying multiple Atlassian applications in a single Tomcat container is not supported. We do not test this configuration and upgrading any of the applications (even for point releases) is likely to break it. There are also a number of known issues with this configuration (see this FAQ for more information).

We also do not support deploying multiple Atlassian applications to a single Tomcat container for a number of practical reasons. Firstly, you must shut down Tomcat to upgrade any application and secondly, if one application crashes, the other applications running in that Tomcat container will be inaccessible.

Finally, we recommend not deploying any other applications to the same Tomcat container that runs Bamboo, especially if these other applications have large memory requirements or require additional libraries in Tomcat's lib subdirectory.

JIRA and Bamboo cannot run in the same Tomcat instance due to a known issue with the Bamboo plugin for JIRA (see JRA-19662).

If integrating Bamboo with JIRA, you should not change the JIRA project key format from the default, as Bamboo only supports the default project key format.

If you need further help, please raise a support request in our support system, in the Bamboo project. You may also want to view articles in the Bamboo Knowledge Base and browse our forums.

Child pages