Working with Bamboo Builds in IDEA

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.

Receive notifications of failed builds.
View the builds.
Re-run a build.
Open the Bamboo build details in an IDEA output tool window.
View the build history for a selected plan.
View a Bamboo build log.
View failed tests and stack traces.
Click a link in a stack trace to go directly to the code that failed.
Re-run a failed test.
View changed files.
Compare the build version of a file with your local version.
Compare the build version of a file with the previous repository version.
Open the repository version of a file in your IDEA editor.
Comment on a Bamboo build.
Label a Bamboo build.

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:

Then select the Bamboo tab in the connector window toolbar:

Using the Bamboo Builds Tab

The Bamboo builds tab shows information about all builds on all servers defined in the connector configuration panel.

The information available 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: The Bamboo builds tab in the connector window

You can filter your builds by server, project or state and then group them by server, project, state or date. The panel at the right of the tab shows the build history for the selected plan.

The icon next to each build shows:

	A coffee cup for the builds in the queue. (Available in Bamboo 2.3 and later.)
	A spinning icon for the builds in progress. (Available in Bamboo 2.3 and later.)
	A red exclamation mark for failed builds.
	A green tick for builds that have passed.

Using the Toolbar

The toolbar in the Bamboo builds tab provides the following functionality:

Define the method of filtering your build display, as shown in the left-hand column of the Bamboo builds tab. You can choose:

None — Display a flat list of builds, without any filtering. The left-hand column of the Bamboo builds tab will disappear, so that you see only the list of builds.
Server — Filter the builds per Bamboo server.
Project — Filter the builds by project.
State — Filter the builds by build status.

Divide the list of Bamboo builds into groups. You can choose:

None — Display a flat list of builds, in no particular order.
State — Display the issues per build status. For example, this would group all successful builds under one heading and all failed builds under another heading.
Project — Display the builds per project.
Server — Display the builds per server, if you have selected more than one Bamboo server.
Date — Group the builds depending on the date last run. The connector groups the issues into logical time periods: today, yesterday, last week, etc.

	Open the connector configuration panel.
	Refresh the contents of the list by polling the configured Bamboo servers.
	Open all the build groups, so that you can see the list of builds under every heading.
	Close all the build lists for all groups, so that you can see only the group headings.
	Open the selected build in an IDEA output tool window. See below.
	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:

Go to the Bamboo builds tab in the connector window, described above.
Select a build and then click the 'Open Build' icon . The build will open in an IDEA output tool window.
Click the 'Changes' tab.

Screenshot: Bamboo build window, showing the changes in the build

You can select a toolbar option or right-click on a file to perform the following actions:

	Open the changed file in your IDEA editor.
	Open a window showing two versions of the changed file (the version in the selected Bamboo build and your local copy) side by side, highlighting the differences between the two versions.
	Open a window showing two versions of the changed file (the version in the selected Bamboo build and the version just before that) side by side, highlighting the differences between the two versions.
	Retrieve the latest version of the file from your source repository and open it in your IDEA editor.
	Remove the folder tree from the display and show a simple list of changed files.
	Display the tree of folders in which the changed files reside.
	If you are showing the folder tree, select this option to open all the folders, so that you can see the list of files under every heading.
	If you are showing the folder tree, select this option to close all the file lists, so that you can see only the folder names.

Viewing Failed Tests

The 'Tests' tab displays a list of the tests which have failed in the selected build. To access this tab:

Go to the Bamboo builds tab in the connector window, described above.
Select a build and then click the 'Open Build' icon . The build will open in an IDEA output tool window.
Click the 'Tests' tab.

Screenshot: Bamboo build window, showing the failed tests in the build

You can perform the following actions:

Select a test in the left-hand pane to see a stack trace in the right-hand pane.
Click a hyperlinked file in the stack trace to open the source file in your IDEA editor.
Right-click a test or a group of tests in the left-hand pane to see a popup context menu, allowing you to:
- Re-run the tests.
- Debug the tests.
- Open the source file in your IDEA editor.

ページツリー