r1513 - in website/trunk (developers.rst)

[Brian Sutherland]

    Date: Wednesday, June 10, 2009 @ 09:49:41
  Author: jinty-guest
Revision: 1513

Add section on setting up a buildslave

Modified:
  website/trunk/developers.rst

Modified: website/trunk/developers.rst
===================================================================
--- website/trunk/developers.rst	2009-06-10 08:29:14 UTC (rev 1512)
+++ website/trunk/developers.rst	2009-06-10 09:49:41 UTC (rev 1513)
@@ -70,3 +70,51 @@
     adt-run --source x.dsc --- sudo adt-virt-null
 
 There is also a buiildbot that runs the autopkgtests on a regular basis. In the future it would be nice to have a buildslave for unstable and testing to make sure packages with failing tests do not reach testing. The buildbot is here: http://packages.vanguardistas.net/pkg-zope-buildbot/
+
+Setting up a Buildslave
+-----------------------
+
+If you want to help out with the testing effort, you can run a buildslave.
+Here's how you set one up.
+
+Before you start, you need to make sure you have a machine with a static IP.
+You need to give this IP to the buildmaster administrator and get a
+name/password pair. It is preferable that you run the buildslave as a virtual
+machine which you don't care about. The buildmaster needs to run commands in
+the buildslave as root.  To setup a buildslave::
+
+        apt-get install buildbot cowdancer
+        cowbuilder --create --distribution ${distribution} --basepath /var/cache/pbuilder/${distribution}.cow
+
+Then edit /var/cache/pbuilder/${distribution}.cow/etc/apt/sources.list and add
+deb and deb-src lines for the repositories you wish to test against. Source
+packages are downloaded via `apt-get source` built and installed. Their
+dependencies are fulfilled via apt-get. For example, to test the packages from
+unstable against their build and test dependencies in testing, you could do::
+
+        deb http://ftp.de.debian.org/debian/ testing main
+        deb-src http://ftp.de.debian.org/debian/ unstable main
+
+Normally, however you will want to build and test against the same distributions.
+
+Next, update the chroot to check all is well::
+
+        cowbuilder --update --basepath /var/cache/pbuilder/${distribution}.cow
+
+To setup the buildbot buildslave do::
+
+        buildbot create-slave /var/lib/buildbot/slave-pkg-zope packages.vanguardistas.net:9990 ${buildslave_name} ${random_password}
+
+Then edit `/var/lib/buildbot/slave-pkg-zope/info` and `/etc/default/buildbot`. `/etc/default/buildbot` should contain something like::
+
+        BB_NUMBER[0]=0                  # index for the other values; negative disables the bot
+        BB_NAME[0]="slave-pkg-zope"             # short name printed on startup / stop
+        BB_USER[0]="root"               # user to run as
+        BB_BASEDIR[0]="/var/lib/buildbot/slave-pkg-zope"                # basedir argument to buildbot (absolute path)
+        BB_OPTIONS[0]=""                # buildbot options
+        BB_PREFIXCMD[0]=""              # prefix command, i.e. nice, linux32, dchroot
+
+Finally start the buildbot::
+
+        /etc/init.d/buildbot restart
+