Setting up Bamboo Development Environment in IDEA

You need to acquire a Commercial License to gain access to Bamboo Source code. Once you have downloaded Bamboo source code, please follow the instructions below to set up Bamboo in IDEA. If you have any problems check with our Troubleshooting Guide.

Building Bamboo 2.4

Install Maven 2.1
Install JDK 1.5 (Doesn't work with 1.4 ).
Download the settings.xml attached to this page, to your <USER_HOME>/.m2/ directory
In the atlassian-bamboo/components directory run mvn clean install -Dmaven.test.skip=true.

Coping with Sun JAVA libraries

Due to licensing restrictions, we are not allowed to re-distribute native SUN libraries through our maven2 public repositories.

If you are developing plugins for Bamboo or building Bamboo from source, you might need javax.mail and javax.transaction:jta:jar for Bamboo to build successfully. Please visit Working with Sun JAVA libraries for further details.

In the atlassian-bamboo directory run mvn idea:clean idea:idea -DdownloadSources=true -Pall
This should generate atlassian-bamboo.* files in your source directory. Open the project with Idea.
Right click on atlassian-bamboo-web-server module (on the left hand panel under Projects) and click on module settings. Click on the dependencies tab and add atlassian-bamboo-web-app. as a dependent module.
Add the application (Run > Edit Configurations > Add New Configuration (of type "Application"):

Main Class	`com.atlassian.bamboo.server.Server`
VM Params	`-Dorg.mortbay.xml.XmlParser.NotValidating=true -Dbamboo.home=home1 -server -Xmx512m -XX:MaxPermSize=126m`
Program Params	`8085 pathtobamboo/bamboo-web-app/src/main/webapp /`
Working Dir	`D:\dev\src\atlassian\bamboo-home`
Class Path of Module	`atlassian-bamboo-web-server`

Atlassian Module Sources

The Bamboo Source Distribution also ships with the source for several of Atlassian's common modules. If you wish to view the source for these in IDEA:

Open Project settings
Find the corresponding dependency in amongst the Bamboo modules (this is the fun part!) and click Edit.
Select 'Attach Sources'
Locate the module source and select the directory above the root package (in Atlassian modules this is usually src/main/java):

Now you should be able to navigate and debug into the source of that module.