CruiseControl is both a continuous integration tool and an extendable framework for creating custom continuous build processes.
Gearset's integration with CruiseControl allows you to see the results of your automated test jobs in the menu bar of your computer. It's a fast and easy way to check the health of your orgs at a glance and quickly get notified if your tests start failing.
Installing a CruiseControl client
The first step is to install a CruiseControl client on your computer. These small applications manage the connection between Gearset and your computer and allow you to customise your notification preferences. There are numerous clients out there, so we've picked two of our favourites to get you started.
The downloads and documentation can be found at http://cruisecontrol.sourceforge.net/
CCTray is a free tool which supports CruiseControl feeds. Follow the link for the current feeds and download the executable.
CCMenu is a free app for OSX. It's available from the Mac App store here: https://itunes.apple.com/gb/app/ccmenu/id603117688?mt=12
Integrating Gearset with CCMenu
- In Gearset, click on the Gearset icon in the top right, and then
- Then click on
Notificationson the right.
- In the
Test monitoring Cruise Control feedsection, click
CREATE FEED URL. This will generate a URL you will use when setting up your feed.
- Copy the generated URL - we'll use it in a minute.
- Open CCMenu, and navigate to the
- Click the
- In the
Feed URLbox, paste in the URL you copied from Gearset.
Use URL as entered above.
- Leave the other settings in their default (empty) state.
- CCMenu will list all your unit testing jobs.
- Select a job to add, or command-click to select multiple jobs.
- The selected job(s) will now be listed in the
- The status of the job(s) selected will also be displayed in your menu bar.
- You've now got notifications of your Gearset test jobs right on your desktop.
Test job status
The status of your test jobs is represented by a traffic light system:
- Green = all tests have passed, and code coverage is above the job threshold.
- Yellow = code coverage has dropped below the threshold, but tests are passing.
- Red = one or more tests are failing.
Integrating with other tools
Gearset uses the standard "cctray" XML format for its automation jobs. You'll be able to integrate Gearset with any tool which supports this format.
Please note: while we endeavour to make sure the links in this document are up to date, we can't be responsible for the content of external sites and you should check before installing any software on your computer!