Home | History | Annotate | Download | only in gtk
      1 ==============================================
      2  Running a GTK+ build slave under daemontools
      3 ==============================================
      4 
      5 This directory contains several scripts which can be used to run a WebKitGTK+
      6 build slave under daemontools [1]. This is convenient because daemontools
      7 will automatically restart services when they die, and that means less human
      8 intervention is needed.
      9 
     10 
     11 Dependencies
     12 ============
     13 
     14 In order to use the provided service control files, you will need the
     15 following:
     16 
     17 * The GNU Bash shell (the scripts contain some bash-isms)
     18 
     19 * The daemontools package (or one of its drop-in replacements, like runit
     20   or freedt; but only daemontools has been tested so far).
     21 
     22 * The crash dump monitor also uses "inotifywait" (part of inotify-tools [2])
     23 
     24 In short, in a Debian-based system you can ensure you have the needed bits
     25 with the following command:
     26 
     27   apt-get install inotify-tools daemontools-run
     28 
     29 
     30 Setup
     31 =====
     32 
     33 1. Follow the instructions at http://trac.webkit.org/wiki/BuildBot
     34 
     35 2. Install the dependencies outlined above.
     36 
     37 3. Copy "daemontools-buildbot.conf" to "/etc/daemontools-buildbot.conf"
     38 
     39 4. Edit the configuration file to suit your needs, the comments should
     40    be self-explanatory.
     41 
     42 5. Drop the "buildbot", "pulseaudio" and "xvfb" directories (plus
     43    "crashmon", if desired) to the service control directory of
     44    daemontools; for Debian-based setups that would be "/etc/service"
     45 
     46 
     47 References
     48 ==========
     49 
     50 [1] http://cr.yp.to/daemontools.html
     51 [2] http://wiki.github.com/rvoicilas/inotify-tools/
     52 
     53