This documentation relates to an earlier version of Bamboo.
View

Unknown macro: {spacejump}

or visit the current documentation home.

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 see which issues are being actively coded, which builds have run for an issue, find the build that fixed the issue, download your distribution and much more.

What version of Bamboo and JIRA do I need?

Bamboo-JIRA integration requires the following software versions:

  • Bamboo 2.4 以降
  • JIRA 4.0 以降

If you are using an earlier version of Bamboo and/or JIRA, you can download an older version of the JIRA Bamboo plugin from the Atlassian Plugin Exchange. However, the instructions on this page refer to the latest version of the required plugins (which are bundled with JIRA 4.0 and Bamboo 2.4). We strongly advise you to upgrade JIRA to version 4.0 and Bamboo to version 2.4, if you wish to integrate Bamboo with JIRA.

Configuring Bamboo and JIRA to work together is a simple three step process:

  1. Configure the Bamboo plugin on the JIRA Server
  2. Configure the JIRA plugin on the Bamboo Server
  3. Add your JIRA Server as an OAuth Consumer in Bamboo

開始する前に

セキュリティに関する考慮事項

There are security considerations that you should take into account when integrating Bamboo with JIRA:

  • When you connect JIRA to Bamboo during the integration process below, you must specify a user that JIRA uses to log in to Bamboo (see 1. Configure the Bamboo plugin on the JIRA Server'). Please be aware that when JIRA accesses Bamboo, this user's Bamboo permissions will be used (not the Bamboo permissions of the user who is currently logged into JIRA). For example, 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.
  • Similarly, when you connect Bamboo to JIRA during the integration process below, you must specify a user that Bamboo uses to log in to JIRA (see 2. Configure the JIRA plugin on the Bamboo Server'). Please be aware that when Bamboo accesses JIRA, this user's JIRA permissions will be used (not the JIRA permissions of the user who is currently logged into Bamboo). For example, a user viewing JIRA information in Bamboo will see all issues available to the user specified in the Bamboo-JIRA setup, instead of the issues available under their own permissions.
    To prevent information in JIRA and Bamboo being unintentionally displayed to the wrong users, please ensure that you specify a user with appropriate permissions when connecting JIRA to Bamboo and vice versa.

既知の問題

  • 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 strongly recommend that you do not deploy multiple Atlassian applications in a single Tomcat container for a number of practical reasons. Firstly, you will need to shut down Tomcat to upgrade any application and secondly, if one application crashes, the other applications running in the Tomcat container will be inaccessible.

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

1. Configure the Bamboo plugin on the JIRA Server

The Bamboo Plugin for JIRA is shipped with JIRA, so you do not need to download and install it. You only need to tell JIRA where to find your Bamboo server(s).

To configure your Bamboo plugin,

  1. Launch your JIRA instance, if it is not already running.
  2. In the JIRA 'Administration' screen, go to 'Global Settings' and select the 'Bamboo Servers' link. The Bamboo servers currently set up for your JIRA instance will display (if any).
  3. Click the 'Add Bamboo server' link. The 'Add Bamboo server' page will display.
    (info) You can configure multiple Bamboo servers, but only one server can be associated to one JIRA project at a time.
  4. Enter the following fields:
    • 'Server name' — The name of your Bamboo server.
    • 'Description' (optional)--- A description of your Bamboo server.
    • 'Host' — The URL of your Bamboo instance e.g. {{http://localhost:8085/bamboo/
      }}
    • 'User name' — The user name that JIRA will use to login to Bamboo.
    • 'Password' — The password for the user specified above.
    • 'Associated JIRA projects' — The keys of the JIRA projects (e.g. 'JRA') that will be associated with this Bamboo server. Separate multiple project keys with spaces.
  5. Click the 'Add' button to add your Bamboo server.
  6. You will also need to allow remote API access in JIRA by enabling the 'Allow remote API access' option, as described in that JIRA documentation.

Managing access to Bamboo information in JIRA

Access to Bamboo information in JIRA (i.e. builds information related to issues, versions and projects) is managed by the 'View Version Control' project permission in JIRA. If you have not added this permission to your JIRA project, you will not be able to view any Bamboo information for that project. Read the JIRA documentation on project permissions for instructions on how to add this permission.

Non-standard JIRA issue keys

Please note, that you cannot change the JIRA issue key format from the standard configuration, if you wish to integrate JIRA with Bamboo. See BAM-3492 for further details.

You should now be able view information on your builds in your JIRA instance (e.g. view the related builds on a particular issue). To complete the integration of Bamboo with JIRA, the JIRA Plugin for Bamboo in your instance of Bamboo needs to be configured so that you can view JIRA information in Bamboo.

2. Configure the JIRA plugin on the Bamboo Server

The JIRA Plugin for Bamboo is shipped with Bamboo, so you do not need to download and install it. You simply need to tell Bamboo where to find your JIRA instance and provide it with the necessary authentication details.

To enable the JIRA integration plugin,

  1. Launch your Bamboo instance, if it is not already running.
  2. Click the 'Administration' link in the top navigation bar.
  3. Click the 'JIRA Server' link in the left navigation column under the 'Communication' section. The 'Update JIRA Server Details' page will display.
    • In the 'Host URL' field, type the URL address of your JIRA server (e.g. 'http://jira.atlassian.com').
    • In the 'Username' field, type the name of the JIRA account which your Bamboo server will use to login to your JIRA server.
      (info) This JIRA account does not require JIRA administration permission.
    • In the 'Password' field, type the corresponding password for the JIRA account.
  4. (Optional) In the 'Test' section, type a JIRA issue key in the 'Issue Key' field (e.g. 'BAM-738') and click the 'Test' button. This should display the following message: 'Successfully retrieved JIRA issue from remote server'. If not, check that you can login to your JIRA server using the JIRA account and password you specified in step 4.
  5. When the test is successful, click the 'Save' button.

3. Add your JIRA Server as an OAuth Consumer in Bamboo

The final step required to integrate Bamboo with JIRA is to add your JIRA server as an OAuth Consumer in Bamboo. An OAuth 'consumer' is an application that accesses ('consumes') data from another application. When you add a JIRA server as an OAuth consumer in Bamboo, you are allowing that JIRA instance to access Bamboo's data. You need to do this if you want to add Bamboo gadgets to your JIRA dashboard.

To add your JIRA Server as an OAuth Consumer in Bamboo,

Congratulations! You have successfully integrated Bamboo and JIRA.

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

お困りですか?

If you need further help, please raise a support request in our support system, in the Bamboo project.



Log a request with our support team.



Raise an issue for our developers.



See answers from the community.



Blog and update our documentation.

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.