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, navigate to the My Account
- In the Cruise Control feed section, 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 Projects tab
- Click the + icon
- In the Feed URL box, paste in the URL you copied from Gearset
- Select Use URL as entered above
- Leave the other settings in their default (empty) state
- Click Continue
- CCMenu will list all your unit testing jobs
- Select a job to add, or command-click to select multiple jobs
- Click Add
- The selected job(s) will now be listed in the projects menu
- 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!