This page last changed on Sep 03, 2008 by jgorycki.
The Atlassian IDE Plugin gives you Bamboo build information right there in your integrated development environment.
Before reading the information below, please make sure that you have installed the Atlassian IDE Plugin for IDEA, as described in the Installation Guide, and defined at least one Bamboo server, as described in the Configuration Guide.
On this page:
Icon and Popup showing Bamboo Status
After you have defined the Bamboo servers and plans to monitor, the Bamboo icon in the status bar shows the summary status of 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 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 plugin window, where detailed information is shown. See below.
In addition, when the summary status changes (e.g. when a build fails), a popup window appears to warn you of the problem. You can configure the behaviour of the popup, as described in the Configuration Guide.
Screenshot: Bamboo build notification

Accessing the Bamboo Tab in IDEA
To open the plugin'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 Plugin control button in the IDEA side bar:

- Then select the Bamboo tab in the plugin window toolbar:

Contents of the Bamboo Tab in the Plugin Window
The Bamboo tab of the plugin window shows information about all plans on all servers defined in the plugin configuration panel.
The set of information is different for Bamboo 1.x and Bamboo 2.x servers. Bamboo 2.x servers can return more detailed information than Bamboo 1.x.
Screenshot: Bamboo tab in the plugin window

You can perform the following functions for each line in the list:
- Double-click a line to open the selected plan in a new browser window.
- 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 plan. The available actions depend on the version of Bamboo running on your server.
- For Bamboo 1.x, the only available action is 'Run build', which re-runs the last build of the selected plan.
- For Bamboo 2.x, the list of available actions includes:
- View — Open the selected plan in a new browser window.
- Show Failed Tests — Display a list of the tests which have failed, in an IDEA tool window. (See below.)
- Show Changed Files — Display a commit list and the changed files, in an IDEA tool window. (See below.)
- Add label to build — Label a build. (See below.)
- Add comment to build — Add a comment to a build. (See below.)
- Show Build Logs — Show the full build log within IDEA. (See below.)
- Run build — Re-run the last build of the selected plan.
The tool bar above the list of plans provides more functionality:
— Open the plugin configuration panel.
— Get help on the usage of the Bamboo tab (i.e. open this page in your browser).
— Refresh the contents of the list by polling the configured Bamboo servers.
— Display a list of the tests which have failed, in an IDEA tool window. (See below.)
— Display a commit list and the changed files, in an IDEA tool window. (See below.)
— Show the full build log within IDEA. (See below.)
— Re-run the last build of the selected plan.
— Label a build. See below.)
— Add a comment to a build. (See below.)
Viewing Failed Tests and Stack Traces
To view the tests which have failed in a build:
- Right-click on the build plan and select 'Show Failed Tests' from the popup context menu, or select the failed tests icon
from the tool bar.
- A list of the failed tests appears in the 'Bamboo Failed Tests' window in IDEA, as shown below.
- Click a test to view the stack trace in the right-hand panel of the 'Bamboo Failed Tests' window.
- Click a link in the stack trace to open the source file in the IDEA editor, going directly to the code that failed.
Screenshot: Showing the failed tests and stack trace

Viewing Changed Files
You can view the commit list and the files changed in the build:
- Right-click on the build plan and select 'Show Changed Files' from the popup context menu, or select the changed files icon
from the tool bar.
- The commit list and list of changed files appears in the 'Bamboo Build Changes' window in IDEA, as shown below.
- Use the toolbar options to:
- Jump directly to the source code.
- Show the diff comparing the version in the build with the repository version.
- Show the diff comparing your local version with the version in the build.
- Open the repository version in the IDEA editor.
Screenshot: Showing the files changed in a build

Labelling a Build
You can add a label to the latest build in the plan:
- Right-click on the plan and select 'Add label to build' from the popup context menu, or select the label icon
from the tool bar.
- A dialogue box opens, as shown below. Enter your label text.
Screenshot: Adding a build label

Commenting on a Build
You can add a comment to the latest build in the plan:
- Right-click on the plan and select 'Add comment to build' from the popup context menu, or select the comment icon
from the tool bar.
- A dialogue box opens, as shown below. Enter your comment text.
Screenshot: Adding a build comment

Viewing a Build Log in IDEA
To show the full build log within IDEA:
- Select the Bamboo build plan from your list of watched plans.
- Right-click on the build plan and select 'Show build logs' from the popup context menu, or select the 'Show Build Log' icon
from the tool bar.
- The build log appears in the IDEA editor window, as shown in the screenshot below.
Screenshot: Viewing the full build log in IDEA

RELATED TOPICS
Configuring the Plugin
IDE Plugin User Guide for IDEA
|