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

1. Install Maven 2.1
2. Install JDK 1.5 (Doesn't work with 1.4 ).
3. Download the settings.xml attached to this page, to your <USER_HOME>/.m2/  directory

4. 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.

5. In the atlassian-bamboo directory run mvn idea:clean idea:idea -DdownloadSources=true -Pall

6. This should generate atlassian-bamboo.* files in your source directory. Open the project with Idea.
7. 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.
8. Add the application (Run > Edit Configurations > Add New Configuration (of type "Application"):

Building Bamboo 2.2 or Bamboo 2.3

1. Install Maven 2.0.9
2. Install JDK 1.5 (Doesn't work with 1.4 ).
3. Download the settings.xml attached to this page, to your <USER_HOME>/.m2/  directory

4. 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 our confluence page on Working with Sun JAVA libraries for further details.

5. In the atlassian-bamboo directory run mvn idea:clean idea:idea -DdownloadSources=true -Pall

6. This should generate atlassian-bamboo.* files in your source directory. Open the project with Idea
7. 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.
8. Add the application (Run -> Edit Configurations -> Add New Configuration of type "Application"):

Building Bamboo 2.0.x or Bamboo 2.1.x

1. Install Maven 2.0.7
2. Install JDK 1.5 (Doesn't work with 1.4 ).
3. Download the settings.xml attached to this page, to your <USER_HOME>/.m2/  directory

4. In the atlassian-bamboo directory run mvn clean install -Dmaven.test.skip=true -Pall.

   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 our confluence page on Working with Sun JAVA libraries for further details.

5. Run mvn idea:clean idea:idea -DdownloadSources=true -Pall

6. This should generate atlassian-bamboo.* files in your source directory. Open the project with Idea
7. 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.
8. Add the application (Run -> Edit Configurations -> Add New Configuration of type "Application"):

If you have an external instance of Bamboo running and you wish to debug it you can set up a remote debugger following these instruction. This will provide you with some command line arguments to add to your startup script. If you are using the Atlassian Plugin Archetype and running mvn -Pplugin-debug this already has those command line options included.

If you have any problems take a look at the troubleshooting page.

Building Bamboo 1.2.x

1. Install maven 2.0.7
2. Install JDK 1.5 (Doesn't work with 1.4 ).
3. Download the settings.xml attached to this page, to your <USER_HOME>/.m2/  directory

4. In the Bamboo 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 our confluence page on Working with Sun JAVA libraries for further details.

5. Run mvn idea:clean idea:idea -DdownloadSources=true

6. This should generate atlassian-bamboo.* files in your source directory. Open the project with Idea
7. Right click on atlassian-bamboo module (on the left hand panel under Projects) and click on module settings. Click on the dependencies tab and add all other modules except atlassian-bamboo-web-server. Thus, making the atlassian-bamboo module to be dependent on all the other modules except atlassian-bamboo-web-server
8. Do the same for the atlassian-bamboo-web-server but make it depended only on the atlassian-bamboo module.
9. Add the application. Mine looks like..

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:

1. Open Project settings

2. Find the corresponding dependency in amongst the Bamboo modules (this is the fun part!) and click Edit.

   

3. Select 'Attach Sources'

4. 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.