Rev 839 | Go to most recent revision | Blame | Compare with Previous | Last modification | View Log | RSS feed
BUILD SERVER SETUP
=== INTRO =====================================================================
The SvarDOS build system is entirely stored in the project's svn repository.
This includes many components:
- SvarDOS-specific tools (install, pkg, pkgnet, localcfg, svarcom, help, ...)
- SvarDOS packages
- SvarDOS website
- build scripts and tools
This means that the project's svn tree contains everything that is required
to build SvarDOS.
=== SVN SERVICE ===============================================================
The server must have a subversion service installed with the SvarDOS repository
imported.
The only specific configuration concerns a post-commit hook that should be set
up to create a /tmp/svados_repo_changed.flag file whenever a commit is made to
the repo. Such hook script can be as simple as this:
echo date > /tmp/svardos_repo_changed.flag
exit 0
=== SVN CLIENT ================================================================
The SvarDOS repository should be checked out in /srv/svardos/:
$ svn co svn://127.0.0.1/svardos /srv/svardos
=== WEB SERVICE ===============================================================
A web server with PHP must be running (typically Apache). The PHP installation
needs the php-zip extension (required by buildidx), and the Apache web root
should point at /srv/svardos/website.
=== CRON ACTIONS ==============================================================
A cron job should be configured to run frequently (like every minute) and
execute the /srv/svardos/cron.sh script. This script is responsible for
checking out the local svardos repo whenever a new commit is being made, and
rebuilds the index of the packages repository.
=== MIRRORING THE PROJECT'S SVN ===============================================
Mirroring the project's svn tree (containing all build scripts, packages, etc)
is the best way to make a backup copy of the entire SvarDOS build system along
with all its history. To achieve such mirror, one needs to create an empty
svn repository and populate it using svnsync:
$ svnadmin create /srv/svardos-mirror
$ svnsync init file:///srv/svardos-mirror svn://svn.svardos.org/svardos
$ svn up /srv/svardos-mirror
The same procedure can be used to migrate the SvarDOS build system from one
server to another.
NOTE: The target svn server must allow modification of revision properties.
This is achieved with a svn "pre-revprop-change" hook of two lines:
#!/bin/sh
exit 0
======================================================================= EOF ===