Smolder - continuous integration smoke server

Smolder is a web-based continuous integration smoke server. It's a central repository for you smoke tests for multiple public and private repositories.

Please see Smolder::Manual for how to use it.

Features

• Self contained web application Smolder has its own built-in HTTP server (Net::Server) and database (SQLite).
• Standard Format Smolder uses TAP and TAP Archives as its reporting format. See Smolder::Manual for more details.
• Multiple Notification Channels Smolder can notifiy you of new or failing tests either by email or Atom data feeds.
• Public and Private Projects Use Smolder for your public open source projects, or for you private work related projects. Smolder can host multiple projects of each type.
• Project Graphs Smolder has graphs to help you visualize the changes to your test suite over time. See how the number of tests has grown or find patterns in your failing tests.
• Smoke Report Organization You can organize your smoke reports by platform, architecture or any tag you want. This makes it easy to see how your project is doing on multiple platforms, or with different configurations.

Install

From the CPAN, using the traditional CPAN shell:

$ cpan Smolder

or using cpanminus:

$ cpanm --sudo --skip-satisfied Smolder

From the sources:

$ git clone https://github.com/Smolder/smolder.git
$ perl Build.PL
$ ./Build test
$ sudo ./Build install

The Debian way (this will make and install a .deb package with dh-make-perl):

$ apt-get install libcgi-application-plugin-json-perl libclass-dbi-sqlite-perl \
  libmime-lite-perl libgd-graph-perl libgd-text-perl libhtml-fillinform-perl \
  libfile-slurp-perl libemail-valid-perl libdata-random-perl libdatetime-perl \
  libtap-harness-archive-perl libtemplate-plugin-cycle-perl libfile-sharedir-perl \
  libfile-homedir-perl libfile-mmagic-perl libgd-graph3d-perl libipc-run-perl \
  libtest-www-mechanize-perl libxml-atom-simplefeed-perl libhtml-tagcloud-perl \
  libhtml-formattext-withlinks-perl libdata-formvalidator-perl \
  libcgi-application-server-perl libdatetime-format-strptime-perl \
  libtemplate-plugin-number-format-perl libcgi-application-plugin-logdispatch-perl \
  libcgi-application-plugin-stream-perl libcgi-application-plugin-tt-perl \
  libcgi-application-plugin-validaterm-perl libclass-dbi-plugin-retrieveall-perl \
  libdata-formvalidator-constraints-datetime-perl libnet-server-perl dh-make-perl \
  libtemplate-plugin-number-format-perl
$ dh-make-perl --install --cpan Smolder

Usage

A good practice is to create a dedicated smolder user account.

Then create a directory where to store your smoker data, and create a configuration file:

HostName    smoker.example.com
Port        21234
FromAddress smolder@example.com
DataDir     /home/smolder/main
PidFile     /home/smolder/main/smolder.pid
LogFile     /home/smolder/main/smolder.log

Run the daemon:

$ smolder --daemon --conf /home/smolder/main/smolder.conf

or run as a PSGI application:

$ plackup bin/smolder.psgi

Now you can submit reports by executing your tests using the --archive option of the prove utility:

$ prove --archive test_run.tar.gz

and send them using the provided smolder_smoke_signal utility:

$ smolder_smoke_signal --server smoker.example.com --port 21234 \
    --username smokebot --password s33kret \
    --project MyProject --file test_run.tar.gz

Again, see Smolder::Manual for more details.