doc/README

   1 Roadmap:
   2
   3   Makefile -- nothing interesting.
   4
   5   PLD_Builder/ -- all python stuff live here.
   6
   7   admin/ -- scripts for chroot admin.
   8
   9   architektura.txt -- docs, in Polish.
  10
  11   client/ -- scripts for clients, i.e. developers sending requests
  12
  13   config/ -- configuration
  14
  15   go.py -- testing script, don't touch
  16
  17   bin/ -- scripts for builder account outside chroot
  18
  19     request-handler.sh
  20       Script to be run from procmail on src builder. It process incoming
  21       request, authorizes it and stores in spool/queue.
  22
  23     src-builder.sh
  24       Script to be run from cron on src builder. It looks for new
  25       requests in spool/queue, gets them from there, builds SRPM, and
  26       stores request for binary builders in spool/req_queue (which is
  27       mirrored in www/ directory, signed and compressed). SRPMS and
  28       buildlogs are queued for transmission.
  29
  30     request-fetcher.sh
  31       Run on binary builder.
  32       Fetch queue.gz from src-builder, and distribute requests for all
  33       builders hosted on given account (to spool/queue-<builder> files).
  34
  35     rpm-builder.sh <builder>
  36       Run on binary builder.
  37       Tries to aquire locks for <builder> and for job-slot. If that suceeds,
  38       proccess one request from spool/queue-<builder>.
  39
  40     load-balancer.sh
  41       Run on binary builder.
  42       Checks spool/got_lock. Then run rpm-builder.sh in order determined
  43       from this file (if b1 had lock last time before b2, first run
  44       rpm-builder.sh b1 and then rpm-builder.sh b2), so builders get
  45       the same number of requests.
  46
  47     file-sender.sh
  48       Run on both binary and src builder.
  49       Sends files queued in spool/{ftp,buildlogs}.
  50
  51 Working directories:
  52   lock/
  53   spool/
  54   log/