Using Bamboo with Clover

Getting Started

One-click Clover Integration

Clover has been seamlessly integrated with Bamboo from Bamboo 2.4 and later. Clover reports can be activated in the Builder configuration screen. Please see Enabling the Clover plugin for further details.

To configure Clover activity refer to Clover Reference Guides for your builder:

• Clover for Ant
• Clover for Maven 2

Classic Clover Integration

To use Clover with Bamboo, you need to:

1. Integrate Clover with Bamboo with your build:
   • Clover-for-Ant Installation Guide
   • Clover-for-Maven 2 and 3 Installation Guide
2. And either:
   • call the Clover goal in your plan configuration (see Configuring tasks);
     or:
   • add the maven-clover-plugin report to the reports section in your POM.
3. Ensure that there are tests present in your build plan that generate test results in JUnit test report format.
4. Ensure that your build creates a Clover report (that is, a clover.xml file). Bamboo will use this Clover report as source. 
5. Set up Bamboo to read the Clover report (clover.xmlfile) generated by Clover. To do this:
   1. Ensure the 'Clover output will be produced' check-box is ticked in your plan's build configuration page.
   2. Instruct Bamboo on the location of your 'Clover XML Directory' — where Bamboo will look for the XML report output file from Clover. Please specify the path to your clover.xml file relative to your plan's root directory (e.g your plan's root directory is /home/bamboouser/bamboo-home/xml-data/build-dir/MY_PLAN/ and you would enter target/clover/site/clover.xml). Please do not specify the absolute path.

For further details, please see Configuring tasks.

Common Problems

Q: I have managed to get Clover statistics displayed in numerical form for each build, but the graphs do not show a history of these statistics?
A: The history of Clover is displayed over time periods (e.g. a day, a week, a month), and the minimum data point is per day. The Clover coverage will not display data that is less than a day old.

Q: Will the Bamboo/Clover integration run on failed builds?
A: Before Bamboo version 1.2.1, Bamboo would only report Clover coverage for successful builds. As of Bamboo 1.2.1, Bamboo will report Clover coverage regardless of the build outcome.