[[PageOutline(2-5,Contents,pullout)]]

= Bamboo Trac Integration Plugin

== Description

Integrate [http://www.atlassian.com/software/bamboo/ Bamboo] build results into the Trac timeline and (optionally) provide a navigation bar menu to link to the Bamboo instance. Bamboo is a continuous integration and build server, supported by Atlassian.

This plugin works very similar to the HudsonTracPlugin (and was almost completely based on it), LuntbuildTracIntegration plugin and the Trac Continuum plugin. The build results are obtained from one of the RSS feeds Bamboo provides. 

== Bugs/Feature Requests

Existing bugs and feature requests for BambooTracPlugin are 
[report:9?COMPONENT=BambooTracPlugin here].

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=BambooTracPlugin&owner=grimsy new ticket].

[[TicketQuery(component=BambooTracPlugin&group=type,format=progress)]]

== Download

Download the zipped source from [download:bambootracplugin here].

== Source

You can check out BambooTracPlugin from [http://trac-hacks.org/svn/bambootracplugin here] using Subversion, or [source:bambootracplugin browse the source] with Trac.

== Installation ==

This plugin requires that the [http://www.feedparser.org/ python-feedparser] library is installed on your system.

Install this plugin using `easy_install`:
{{{
#!sh
easy_install http://trac-hacks.org/svn/bambootracplugin/0.11/
}}}

Enable the plugin in `trac.ini`:
{{{
#!ini
[components]
bambootrac.bambootracplugin.* = enabled
}}}

== Configuration

At a minimum, you need the feed_url parameter:
{{{
#!ini
[bamboo]
feed_url= http://localhost/bamboo/rss/createAllBuildsRssFeed.action?feedType=rssAll&os_username=user&os_password=pass
}}}

If you are using basic authentication on your bamboo installation, you '''should''' be able to use the following configuration:
{{{
#!ini
[bamboo]
feed_url= http://localhost/bamboo/rss/createAllBuildsRssFeed.action?feedType=rssAll&os_authType=basic
username = yourusername
password = yourpassword
}}}

'''Note''': I haven't tested the Basic authentication, and just used the same code that the HudsonTracPlugin was using.

== Recent Changes

[[ChangeLog(bambootracplugin, 3)]]

== Author/Contributors

'''Author:''' [wiki:grimsy] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:'''