See the results of your Salesforce org tests on your desktop with Gearset’s CruiseControl integration
Ellis Toms on October 3rd 2017
Have you ever found that your tests have been silently failing, only discovering them when you tried to deploy? Gearset’s test automation makes it easy to track test status across all your orgs and get notified when things start to go wrong.
As part of Gearset’s ongoing effort to increase the visibility teams have into their Salesforce environments, we have recently extended our test automation to integrate with CruiseControl. The result? See the status of your org tests right on your desktop.
What is CruiseControl?
CruiseControl is a continuous integration tool and extendable framework for creating a custom continuous build process. Gearset’s integration with CruiseControl lets you easily view the results of your automated test jobs in the menu bar of your computer and set up desktop notifications to alert you when tests start failing.
In this guide we'll walk you through the process of setting up your own desktop notifications so you'll never get caught out by silent test failures again.
Installing a CruiseControl client
The first step is to install a free CruiseControl client, which will manage the connection between Gearset and your computer. There are many clients to choose from, so we have picked two of our favourites to get you started.
CCTray is a free tool that supports CruiseControl feeds and can be downloaded here.
CCMenu is free for OSX and available from the Mac App Store here.
For the sake of keeping it brief, we’ll be using the CCMenu client to demonstrate how to get you setup in this blog. If you’re on Windows, don’t worry - the process for CCTray is very similar.
Integrating Gearset with CCMenu
In the Gearset app, navigate to your account and under account settings you will see a Cruise Control feed section. Create your feed URL and click
Open CCMenu, navigate to the Projects tab and click the
+ icon at the bottom of the window. Paste the URL that you copied from Gearset into the Feed URL box and select the ‘Use URL as entered above’ box. Leave the rest of the settings in their default state and click
CCMenu will now list all of your Gearset unit testing jobs. You can then select which job, or multiple jobs, you want to monitor and click
And that's it! Your selected job(s) will now be displayed in the desktop menu bar, along with their most recent status. Click on a job in the menu bar to view a complete test run history in the Gearset app. You can also easily adjust notification preferences in CCMenu under the notifications tab.
Monitor your test job status
The status of your test jobs is represented by a traffic light system:
- Green indicates that all tests have passed and code coverage is above the job threshold
- Red tells you that one or more tests are failing
Integrating with other tools
Gearset uses the standard "cctray" XML format for its automation jobs. This means you’ll be able to integrate Gearset with any tool which supports this format.
Let us know your thoughts!
Already using CruiseControl and have feedback? We’d love to hear from you! If you have any questions or suggestions regarding CruiseControl and integration with Gearset please don’t hesitate to get in touch through either the in-app chat or at [email protected].
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!