Mercurial > treepkg
annotate README @ 64:2ff966839859
web: add method to create a static status web-site
| author | Bernhard Herzog <bh@intevation.de> |
|---|---|
| date | Wed, 11 Apr 2007 16:52:58 +0200 |
| parents | 225206553bba |
| children | b52779523392 |
| rev | line source |
|---|---|
| 42 | 1 README for TreePackager |
| 2 ======================= | |
| 3 2007-03-19, Bernhard Herzog <bh@intevation.de> | |
| 4 | |
| 5 | |
| 6 TreePackager is a tool to automatically build debian packages from SVN. | |
| 7 | |
| 8 | |
| 9 Prerequisites | |
| 10 ------------- | |
| 11 | |
| 12 You need the following software to run TreePackager. In the list below, | |
| 13 parentheses contain the name of the corresponding package in Debian Etch | |
| 14 if its not the same as the software. The version required is usually | |
| 15 the one from debian etch. | |
| 16 | |
| 17 Python 2.4 (python2.4-minimal) | |
| 18 Debian devscripts (devscripts) | |
| 19 subversion | |
| 20 pbuilder | |
| 21 sudo | |
| 22 bzip2 | |
| 23 | |
| 24 For the web front-end you also need the following software: | |
| 25 | |
| 26 Genshi (python-genshi) | |
| 27 CherryPy (python-cherrypy) | |
| 28 | |
| 29 Some of the packagers require additional software. The KDEPIM | |
| 30 enterprise branch packagers require the following additional software: | |
| 31 | |
| 32 autoconf2.13 | |
| 33 automake1.9 | |
| 34 | |
| 35 | |
| 36 Installation | |
| 37 ------------ | |
| 38 | |
| 39 You can run the tree packager itself directly from the source tree. | |
| 40 However, you need to configure it first and setup pbuilder. | |
| 41 | |
| 42 | |
| 43 Configuration | |
| 44 ------------- | |
| 45 | |
| 46 To understand the configuration, first a few notes about the | |
| 47 architecture of TreePackager. The TreePackager consist of one program | |
| 48 that periodically updates svn working directories and if something has | |
| 49 changed, builds a new debian package from the working directory. The | |
| 50 program should run as a normal user. The sample configuration assumes | |
| 51 that it's the user "builder" with a home directory "/home/builder". The | |
| 52 default configuration manages a directory tree under | |
| 53 "/home/builder/enterprise". | |
| 54 | |
| 55 The binary packages are built with pbuilder. Because pbuilder uses a | |
| 56 chroot environment to build the packages, it must be run as root. The | |
| 57 tree packager therefore needs a way to run pbuilder as root even though | |
| 58 itself runs as a non-root user. By default the tree packager uses sudo, | |
| 59 so you have to setup sudo to allow the tree packager user to invoke | |
| 60 pbuilder without a password. This can be accomplished with the | |
| 61 following line in /etc/sudoers (using the default user name): | |
| 62 | |
| 63 builder ALL = NOPASSWD: /usr/sbin/pbuilder | |
| 64 | |
| 65 | |
| 66 Configure TreePackager | |
| 67 ~~~~~~~~~~~~~~~~~~~~~~ | |
| 68 | |
| 69 The file demo.cfg contains example configuration that contains most of | |
| 70 what is needed to package KDEPIM and kde-i18n from the KDEPIM enterprise | |
| 71 branch. Copy this file to treepkg.cfg and adapt it to your needs. The | |
| 72 comments in the file should provide enough hints to get you started. | |
| 73 | |
| 74 | |
| 75 Configure pbuilder | |
| 76 ~~~~~~~~~~~~~~~~~~ | |
| 77 | |
|
50
225206553bba
update README part about pbuilder config
Bernhard Herzog <bh@intevation.de>
parents:
42
diff
changeset
|
78 It's best to give the tree packager its own pbuilder configuration and |
|
225206553bba
update README part about pbuilder config
Bernhard Herzog <bh@intevation.de>
parents:
42
diff
changeset
|
79 directories. The default configuration uses a "pbuilder" subdirectory |
|
225206553bba
update README part about pbuilder config
Bernhard Herzog <bh@intevation.de>
parents:
42
diff
changeset
|
80 in /home/builder/enterprise. If you have created the treepkg.cfg file |
|
225206553bba
update README part about pbuilder config
Bernhard Herzog <bh@intevation.de>
parents:
42
diff
changeset
|
81 with at least one packager and the correct root_cmd and pbuilderrc |
|
225206553bba
update README part about pbuilder config
Bernhard Herzog <bh@intevation.de>
parents:
42
diff
changeset
|
82 options (the defaults for both should be OK if you use sudo as described |
|
225206553bba
update README part about pbuilder config
Bernhard Herzog <bh@intevation.de>
parents:
42
diff
changeset
|
83 above), you can create the directories, the pbuilder configuration and |
|
225206553bba
update README part about pbuilder config
Bernhard Herzog <bh@intevation.de>
parents:
42
diff
changeset
|
84 the chroot environment with the script initpbuilder.py like this: |
|
225206553bba
update README part about pbuilder config
Bernhard Herzog <bh@intevation.de>
parents:
42
diff
changeset
|
85 |
|
225206553bba
update README part about pbuilder config
Bernhard Herzog <bh@intevation.de>
parents:
42
diff
changeset
|
86 ./initpbuilder.py --mirrorsite=<URL of preferred debian mirror> |
|
225206553bba
update README part about pbuilder config
Bernhard Herzog <bh@intevation.de>
parents:
42
diff
changeset
|
87 |
|
225206553bba
update README part about pbuilder config
Bernhard Herzog <bh@intevation.de>
parents:
42
diff
changeset
|
88 You can specify some more mirrors with the --othermirror option. For |
|
225206553bba
update README part about pbuilder config
Bernhard Herzog <bh@intevation.de>
parents:
42
diff
changeset
|
89 more information run "./initpbuilder.py --help" and consult the pbuilder |
|
225206553bba
update README part about pbuilder config
Bernhard Herzog <bh@intevation.de>
parents:
42
diff
changeset
|
90 documentation. |
| 42 | 91 |
| 92 | |
| 93 Configure the web front-end | |
| 94 ~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
| 95 | |
| 96 The default configuration should be OK in most cases. If you want you | |
| 97 can customize it in cherrypy.cfg. Start the web front-end with | |
| 98 | |
| 99 ./starttreepkgweb.py | |
| 100 | |
| 101 starttreepkgweb has some options to specify which configuration files to use. |