The Atlassian Connector for IntelliJ IDEA lets you monitor and act upon your Bamboo builds from within IntelliJ IDEA.

Prerequisites

Please make sure that you have installed the Atlassian Connector for IntelliJ IDEA, as described in the Installation Guide, and defined at least one Bamboo server, as described in the Configuration Guide.

Summary of What You Can Do

Below are the highlights of viewing and acting upon Bamboo builds within IDEA. Follow the links to the relevant sections of the user guide.

Watching the Bamboo Status Icon and Popup

After you have defined the Bamboo servers and builds to monitor, the Bamboo icon in the status bar shows the summary status of your builds. If at least one build is currently failing, the icon is red, otherwise it is green.

Screenshot: Bamboo status icon in the IDEA status bar

The screenshot above shows a red Bamboo status icon in the status bar, with the tooltip 'Some builds failed. Click to see details.'

If the Bamboo tab is not already open, you can click the status icon to open the Bamboo tab in the connector window, where detailed information is shown. See below.

In addition, when the summary status changes (e.g. a build fails), a popup window appears to warn you of the problem. You can configure the behavior of the popup, as described in the Configuration Guide.

Screenshot: Bamboo build notification

Accessing the Bamboo Builds Tab in IDEA

To open the connector's Bamboo tab in IDEA, you can do one of the following:

Click the Bamboo status icon in the IDEA status bar. The icon may be red or green.

Or click the Atlassian Connector control button at the bottom of the IDEA screen:

Open the selected build in your browser, using the Bamboo user interface.

Re-run the selected build.

Label a build.

Add a comment to a build.

Search for a build by entering your plan and build number. The build will open in IDEA.

Get help on the usage of the Bamboo build tab, i.e. open this documentation page in your browser.

The search box gives you quick access to a build. Just type the build number into the search box at top right of the Issues tab. The connector will display matching builds as you type.

View the details of the historical build selected in the build history panel.

Using the Context Menu for a Build

You can perform the following functions for each line in the list:

Double-click a line to open the selected build in an IDEA output tool window. See below.

Right-click a line to show a popup context menu (also shown in the screenshot above) with actions that can be performed for a Bamboo build. The available actions depend on the version of Bamboo running on your server.

Open Build — Open the selected build in an IDEA output tool window. See below.

View in Browser — Open the selected build in your browser, using the Bamboo user interface.

Run Build — Re-run the last build of the selected plan.

Add Label to Build — Label a build.

Add Comment to Build — Add a comment to a build.

Viewing and Acting Upon Builds

From the Bamboo builds tab, described above, you can open a Bamboo build in an IDEA output tool window. For example, you can do one of the following:

Select the build and then click the 'Open Build' icon , or

Right-click the build line and then select 'Open Build' from the popup context menu, or

Double-click the build line.

The build will open in an IDEA output tool window. The window will have a number of tabs, displaying information related to the build.

Viewing Build History

The panel on the right of the Bamboo builds tab (described above) shows the build history for the selected plan. Double-click a specific build, or click the 'Open Build Details' icon, to open the build in your IDEA tool window.

Viewing Build Details

Screenshot: Bamboo build window, showing the build details

The toolbar provides the following functionality:

Open the selected build in your browser, using the Bamboo user interface.

Re-run the last build of the selected build.

Label a build.

Add a comment to a build.

Close the build window in IDEA.

If there are any JIRA issues linked to the builde, the 'Details' tab in the Bamboo build window will show a list of linked JIRA issues. (Refer to the Bamboo documentation on linking an issue to a build). You can click the issue key in IDEA to open the issue in JIRA, in your web browser.

Viewing Build Changes

The 'Changes' tab displays a commit list and the changed files. To access this tab: