This is the documentation for Bamboo 5.7. View this page for the

Unknown macro: {spacejump}

of Bamboo, or visit the latest Bamboo documentation.

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

Configuring Bamboo and a JIRA application to work together simply requires you to set up an application link (two-way) between the JIRA application and Bamboo.

Note that application links have nothing to do with using a JIRA application as a user directory for Bamboo; these 2 configurations can exist separately. See also Linking to another application.

On this page:

メリット

See Viewing Bamboo activity in JIRA applications for a full description of the benefits of integrating JIRA with Bamboo.

Briefly, these are:

連携機能説明

Compatibility

JiraBamboo
開発パネルSee Bamboo development activity in a JIRA application6.2 以降5.4 以降
Build result dialogView detailed Bamboo build result information in a JIRA application6.2 以降5.4 以降
Deployment dialogView detailed Bamboo deployment information in a JIRA application6.2 以降5.4 以降
Run Bamboo builds

Run a Bamboo build when releasing a JIRA application version

4.4 以降3.0 以降
Linked plan branches

Have Bamboo automatically link a plan branch with an issue

4.4 以降3.0 以降
Issues view

View the issues linked to a build result

4.4 以降3.0 以降
プロジェクト

View the Bamboo builds that relate to a project or version

4.4 以降3.0 以降

 

If you are using an earlier version of Bamboo and/or JIRA applications, 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 6.2 or later and Bamboo to version 5.4 or later, to get the most out of Bamboo - JIRA integration.

要件

要件説明

Jira 6.2 以降

Earlier versions do not support the Development panel feature.
Bamboo 5.4+ 
JIRA/Bamboo Applink

See below for details about application links.

権限

Users will require the 'View development tools' permission in JIRA.

課題キーThe issue key must be included in the commit message, and must use the default issue key format.

構成

Integration of Bamboo and a JIRA application requires an application link between them. The application link needs both 2-legged (2LO) and 3-legged OAuth (3LO) authentication:

  • 2LO is required for information from Bamboo to be included in the summaries in the Development panel.
  • 3LO checks that a user has authenticated with Bamboo before they get to see the information in any of the details dialogs. Users who can see summarized data in the Development panel may not have permission to see all the information that contributed to those summaries and which is visible in the details dialogs. That is, the details dialogs respect the access permissions that users have in the connected Bamboo server.

When you create a new application link between a JIRA application and Bamboo, both 2-legged (2LO) and 3-legged OAuth (3LO) are enabled by default. 

  • You will need to set up a two-way link. That is, select the Create a link back to this server option when adding the application link.

An existing application link between a JIRA application and Bamboo may need to have 2LO authentication explicitly enabled.

An existing application link between a JIRA application and Bamboo (that perhaps used Trusted Apps authentication) needs to have 2-legged authentication (2LO) enabled for both outgoing and incoming authentication, so that information from the application can be included in the Development panel summaries.

When updating an older application link to use OAuth, 3-legged authentication is applied by default, but you need to explicitly enable 2LO. Enable 2-legged authentication for the application link from within a JIRA application as follows:

  1. Go to the admin area and click Add-ons > Application Links
  2. 他のアプリケーションのアプリ リンクの編集をクリックします。
  3. For both Outgoing Authentication and Incoming Authentication:
    1. Click OAuth
    2. Check Allow 2-legged OAuth.
    3. Click Update.

The application link update process will involve logging you into the other application for a short time to configure that end of the link, before returning you to a JIRA application.

注意:

  • Application links must have Trusted Applications and Basic Access authentication disabled. The Development panel in JIRA applications only supports OAuth authentication.
  • You will need to configure 2-legged OAuth enabled for both incoming and outgoing authentication in both JIRA applications and Bamboo for your application link. 
  • See Configuring authentication for an application link for more information.
  • If you are running Bamboo behind a proxy, you may need to configure the AJP connector.

注意

既知の問題

  • JIRA applications and Bamboo cannot run in the same Tomcat instance due to a known issue with the Bamboo plugin for JIRA applications (see JRA-19662). 
  • If integrating Bamboo with JIRA applications,  you should not change the 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.