Logroll v0.17 is out with bug fixes and some ease of use improvements.
Download it now and make your Automated Build Studio server do fancy tricks like:
- Create and update a slick build status web page with summary and detail views.
- Create a build server status RSS feed you can add to your home page
- Play different music based on build pass or fail
- Send build status updates to email and mobile phones
Download Logroll The project RssSampleProject.bxp in the Logroll archive is pre-configured to demonstrate Logroll.
How to use the RssSampleProject with Logroll:
1. Copy all files that came with Logroll to a new directory.
2. Open RssSampleProject.bxp in ABS.
3. Double-click the Configure Logroll/Export Log operation.
Edit the message text to set the options for your FTP server,
web server and email preferences.
4. Upload abs_rss.css, abslog.css and abs_rss.xsl and the gif files to
the same directory you specified in the Configure Logroll
setting ServerLogPath. These files allow you to view
(YourMacroName)_rss.xml feed as a normal web page.
5. If you set PlayMusic, add the playlists ABS_Fail and ABS_Pass to iTunes
and fill them with appropriate tracks.
6. Save RssMacroSample.bxp and run it.
The macro will randomly succeed or fail and it will call Logroll to
handle the log. Skip to the "Setup your feed reader" section below
to read more.
You can add Logroll to your macros with just a few easy steps.
How to add Logroll to your macro:
1. Copy logroll.bxp to your macro directory.
2. Open your macro in ABS.
3. Open the RSSSampleProject macro in another instance of ABS.
4. Copy the FinalAction submacro from RSSSampleProject to your macro.
5. In your macro, create a new submacro with the name GlobalError.
6. In your macro, add operation 'Run submacro' to end of the GlobalError
submacro, set it to call FinalActions.
7. In your macro, set the macro properties to 'Run submacro if fails:'
to run GlobalError. (Files/Macro Properties)
8. In your macro, double-click the Configure Logroll/Export Log operation.
Edit the message text to set the options for your FTP server,
web server and email preferences.
9. Upload abs_rss.css, abslog.css and abs_rss.xsl and the gif files to
the same directory you specified in the Configure Logroll
setting ServerLogPath. These files allow you to view
(YourMacroName)_rss.xml feed as a normal web page.
10. If you set PlayMusic, add the playlists ABS_Fail and ABS_Pass to iTunes
and fill them with appropriate tracks.
11. Run your macro.
Try it out
Once you've modified your macro to call Logroll and changed the settings
for your servers and email, just run your macro to test it.
If your FTP server settings are good, Logroll will upload the log
to an RSS file on your webserver after every build and you can monitor
macro status from your RSS reader.
Logroll will also upload an HTML version of the log file to the same
directory so you can drill down on summaries to see log details.
(note: older html logs are not cleaned up yet, that's coming in the next version.)
If your email settings are good, Logroll will email log summaries to
each email address you specified when the build passes, fails or always.
If you have iTunes installed, Logroll will play a song from the playlists
ABS_Fail or ABS_Pass when your macro passes or fails.
Setup your feed reader:
Add the feed to your RSS feed reader.
The feed URL will be something like:
http://(yourserver.com)/abslogs/(YourMacroName)_rss.xml.
View it in your browser:
Just load http://(yourserver.com)/abslogs/(YourMacroName)_rss.xml in
your browser.
Notes:
* Logroll will create empty ABS_Fail and ABS_Pass feeds in iTunes if
you don't create them.
* RSS reader services like Bloglines, Microsoft Live and Google don't
update immediately. Use a desktop feed reader for immediate feedback.
Download Logroll version 0.17