wiki:HowtoContributeABuildbot

Version 23 (modified by marcusw, at 2011-11-21T04:05:45Z) (diff)

Fixed the allmydata.org domain names

Prerequisites

You'll need darcs and buildbot before you can proceed.

Configuration

Create a user account with low privileges to run buildbot.

Optional Configurations

You can use other mechanisms to lock buildbot down like jail, or chroot. David Abrahams uses Solaris Zones to contain his buildslaves. Brian Warner and the other buildbot maintainers have been hacking on some tricks to set up your buildslaves inside a full virtual machine so that you can have a pristine machine for every build.

Name The Buildslave

Choose a name for your buildslave which will fit into the list of buildslave names: http://tahoe-lafs.org/buildbot/buildslaves . A hostname would be a good choice.

Get a Password

Email Zooko (zooko_at_zooko_dot_com) and ask for a password.

Create a Buildslave

Execute the following commands:

  • Tahoe-LAFS: buildbot create-slave $BASEDIR_TAHOE tahoe-lafs.org:9987 $SLAVENAME $PASSWORD
  • Zfec: buildbot create-slave $BASEDIR_ZFEC tahoe-lafs.org:12987 $SLAVENAME $PASSWORD
  • Pycryptopp: buildbot create-slave $BASEDIR_PYCRYPTOPP tahoe-lafs.org:10998 $SLAVENAME $PASSWORD

Those three use the same $SLAVENAME, $PASSWORD and hostname, but a different $BASEDIR and a different port number.

For the $BASEDIR your can use whatever directory you want.

Use a different user account for tahoe-lafs, pycryptopp, and zfec buildslaves.

Then buildbot start $BASEDIR.

Monitor Output

Okay, once you've gotten all this working then we'll see your machine on the buildbot pages and we'll see how well Tahoe-LAFS passes unit tests on your platform.

More Details

The official buildslave creation documentation is here.