Before You Begin

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.

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.
• 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:

1. Go to your JIRA dashboard.
2. Click Add Gadget.
3. In the 'Gadget Directory' dialog, click Gadget Subscriptions.
4. In the 'Gadget Subscriptions' dialog, click Add Subscription.
5. 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.
6. Click Add Subscription.
7. 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.

Related Topics

Configuring Application Links (JIRA documentation)