Subversion Repositories SvarDOS

Rev

Rev 839 | Rev 844 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
636 mateusz.vi 1
 
2
 
3
                             BUILD SERVER SETUP
4
 
5
 
6
 
7
=== INTRO =====================================================================
8
 
9
The SvarDOS build system is entirely stored in the project's svn repository.
10
This includes many components:
11
 
12
 - SvarDOS-specific tools (install, pkg, pkgnet, localcfg, svarcom, help, ...)
13
 - SvarDOS packages
14
 - SvarDOS website
15
 - build scripts and tools
16
 
17
This means that the project's svn tree contains everything that is required
18
to build SvarDOS.
19
 
20
 
21
=== SVN SERVICE ===============================================================
22
 
23
The server must have a subversion service installed with the SvarDOS repository
24
imported.
25
 
837 mateusz.vi 26
The only specific configuration concerns a post-commit hook that creates a flag
27
file at /tmp/svados_repo_changed.flag whenever a commit is made to the repo and
28
another flag in /tmp/svardos_rebuilt_please.flag if the commit might impact the
29
content of installation images. Here below is the necessary post-commit hook,
30
it should be placed in the hooks/ directory of the svn server and made
31
executable (chmod +x):
636 mateusz.vi 32
 
837 mateusz.vi 33
#!/bin/sh
636 mateusz.vi 34
 
837 mateusz.vi 35
SVNLOOK=/usr/bin/svnlook
36
REPOS="$1"
842 mateusz.vi 37
REV="$2"
636 mateusz.vi 38
 
837 mateusz.vi 39
# first of all, make sure to set a flag that says "svn content changed" so a
40
# cron job can update its local copy later
842 mateusz.vi 41
echo `date` > /tmp/svardos_repo_changed.flag
837 mateusz.vi 42
 
43
# check if any of the following locations have been updated during the commit:
44
#  - files
45
#  - packages/core/
46
#  - build.sh
47
#
48
# any change to one of these locations means that the content of the
49
# installation images may have been impacted, hence a rebuild may be necessary.
50
#
842 mateusz.vi 51
$SVNLOOK changed -r "$REV" "$REPOS" | grep -e ' files' -e ' build.sh' -e ' packages/core/' > /dev/null
837 mateusz.vi 52
 
53
# if a location matched, then set a flag so a cron job rebuilds the images
54
# and send an information message back to the committer.
55
if [ $? -eq 0 ] ; then
842 mateusz.vi 56
  echo `date` > /tmp/svardos_rebuild_please.flag
837 mateusz.vi 57
  echo "NOTICE: a build-impacting location has been updated." >&2
58
  echo "        install images have been scheduled for a rebuilt." >&2
59
  exit 1
60
fi
61
 
842 mateusz.vi 62
exit 0
837 mateusz.vi 63
 
842 mateusz.vi 64
 
636 mateusz.vi 65
=== SVN CLIENT ================================================================
66
 
67
The SvarDOS repository should be checked out in /srv/svardos/:
68
 
69
$ svn co svn://127.0.0.1/svardos /srv/svardos
70
 
71
 
72
=== WEB SERVICE ===============================================================
73
 
74
A web server with PHP must be running (typically Apache). The PHP installation
75
needs the php-zip extension (required by buildidx), and the Apache web root
76
should point at /srv/svardos/website.
77
 
78
 
79
=== CRON ACTIONS ==============================================================
80
 
81
A cron job should be configured to run frequently (like every minute) and
82
execute the /srv/svardos/cron.sh script. This script is responsible for
83
checking out the local svardos repo whenever a new commit is being made, and
84
rebuilds the index of the packages repository.
85
 
86
 
87
=== MIRRORING THE PROJECT'S SVN ===============================================
88
 
89
Mirroring the project's svn tree (containing all build scripts, packages, etc)
90
is the best way to make a backup copy of the entire SvarDOS build system along
91
with all its history. To achieve such mirror, one needs to create an empty
92
svn repository and populate it using svnsync:
93
 
94
$ svnadmin create /srv/svardos-mirror
95
$ svnsync init file:///srv/svardos-mirror svn://svn.svardos.org/svardos
96
$ svn up /srv/svardos-mirror
97
 
98
The same procedure can be used to migrate the SvarDOS build system from one
99
server to another.
100
 
101
NOTE: The target svn server must allow modification of revision properties.
102
      This is achieved with a svn "pre-revprop-change" hook of two lines:
103
        #!/bin/sh
104
        exit 0
105
 
106
 
107
======================================================================= EOF ===