another readme
[build.git] / README-build.txt
1 Notes on using this build
2
3 * install a vserver-enabled kernel and util-vserver on your build box
4 * create a local fedora mirror - see vbuild-fedora-mirror.sh
5 * create a vserver - see vbuild-init-vserver.sh
6 * enter the vserver and svn export this build module into /build 
7 * cd /build and ru
8 # make stage1=true PLDISTRO=yourdistro
9 # make help
10 # make
11
12 === automated builds
13 * the nightly build script wraps all this in a rather complicated way
14 it is not intended to be used as is without a few manual tweaks on your
15 build and test hosts
16 basically it
17 ** recreates a fresh build vserver named after the arguments
18 ** enters this to perform the actual build
19 ** pushes the results to a web location so the tests can pull the
20 right myplc rpm
21 ** invokes a runtest on a separate machine
22 ** manages logs - that's the trickiest part, so the root context and
23 the vserver add their logs on the same file
24  
25 === manual builds
26 * always run the stage1 make prior to anything else
27 * if you clean or patch a spec file you need to run the stage1 again
28 * see make help for how to do things incrementally
29
30 * typically if you want to test a change without commiting first, you
31 need to:
32 ** make package-codebase
33 ** patch CODEBASE/module/
34 ** make package
35
36 if further changes are needed, then do
37 ** make package-clean-tarball package-clean-build package-clean-rpm
38 so the codebase remains intact, patch it again and run
39 ** make package