This page last changed on Sep 17, 2008 by smaddox.

The Atlassian Eclipse Connector gives you Bamboo build information right there in your Eclipse integrated development environment. This page tells you how to use the Bamboo view provided by the Atlassian Eclipse Connector.

On this page:

Icon and Popup showing Bamboo Status

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

If the Eclipse Bamboo view is hidden, you can double-click the status icon to open the Bamboo view, where detailed information is shown.

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 in the Preferences window.

Screenshot: Bamboo popup window



Accessing the Bamboo Views in Eclipse

There are two Bamboo views available: 'Bamboo Servers' and 'Bamboo Watched Plans'.

Screenshot: Accessing the Bamboo views



To open the views:

  1. In Eclipse, click the 'Window' menu and select 'Show View' then 'Other'.
  2. Expand the folder named 'Atlassian Plugin'.
  3. Select 'Bamboo Servers' or 'Bamboo Watched Plans'.
    Hint: Hold down the Control key to select more than one view at the same time.
  4. Click 'OK'.
  5. The selected Bamboo view(s) will open, as shown in the screenshots below.

Contents of the 'Bamboo Watched Plans' View

The Bamboo Watched Plans view shows information about all build plans of the server defined in the Preferences window. (See Configuring the Atlassian Eclipse Connector.)

Screenshot: Bamboo Watched Plans



You can change the order of the columns in the view. Just click a column heading and drag it to the new position. The connector will remember the column order the next time you start Eclipse.

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.
  • Select a line to enable the actions in the tool bar.


The tool bar above the list of plans provides more functionality:

  • — Re-run the last build of the selected plan.
  • — Label a build.
  • — Add a comment to a build.
  • — Show the full build log within the Eclipse IDE. (See below.)
  • — Refresh the contents of the list by polling the configured Bamboo server.

Contents of the 'Bamboo Servers' View

The Bamboo Servers view is not yet fully functional

The Bamboo Servers view is still under development. When complete, this view will replace the server configuration on the connector Preferences window, which is described in Configuring the Atlassian Eclipse Connector. On the Bamboo Servers view described below, you can add servers and browse plans but nothing more.

The Bamboo Servers view shows a list of available Bamboo servers, and allows you to add another server to the list.

Screenshot: Bamboo Servers



To add a server:

  1. Click the New Server icon in the tool bar above the list of servers.
  2. The 'New Bamboo Server' screen will appear, as shown below.
  3. Supply the information as prompted then click 'Finish'.

Screenshot: Adding a Bamboo Server



Viewing a Build Log in Eclipse

To show the full build log within the Eclipse IDE:

  1. Select the build plan from your list of watched plans. (See above.)
  2. Click the 'Show Build Log' icon in the toolbar.
  3. The build log appears, as shown in the screenshot below.


Screenshot: Full build log in Eclipse IDE

RELATED TOPICS

Installing the Atlassian Eclipse Connector
Configuring the Atlassian Eclipse Connector
User Guide for the Atlassian Eclipse Connector


Document generated by Confluence on Nov 12, 2008 17:20