diff --git a/HowtoContributeABuildbot.md b/HowtoContributeABuildbot.md index b24a0ea..bf99ac5 100644 --- a/HowtoContributeABuildbot.md +++ b/HowtoContributeABuildbot.md @@ -1,12 +1,13 @@ -Contributing a buildbot improves the quality of Tahoe-LAFS and also is integral to defining out supported platforms, as described in [Buildbot Policy](BuildbotPolicy). You can see the results of our builtbot network in the [//buildbot-tahoe-lafs the Buildbot output page]. +Contributing a buildbot improves the quality of Tahoe-LAFS and also is integral to defining out supported platforms, as described in [Buildbot Policy](BuildbotPolicy). You can see the results of our buildbot network in the [//buildbot-tahoe-lafs the Buildbot output page]. ## Prerequisites -1. Install [git](http://git-scm.com/). -1. Install [Python 2.7](https://www.python.org/download/releases/2.7.8/). -1. Install setuptools: download [ez_setup.py](https://bootstrap.pypa.io/ez_setup.py) into a directory with no Unicode characters in the path, and run it using `python ez_setup.py`. -1. Run "`easy_install pip`". -1. Run "`pip install buildbot-slave`". Do this in a virtualenv if you prefer. (If this doesn't work, see the instructions on the [Buildbot trac](http://trac.buildbot.net/wiki/DownloadInstall) for installing buildbot-slave.) +1. Install [git](http://git-scm.com/) (ideally using your OS package manager) +1. Install [Python 2.7](https://www.python.org/download/releases/2.7.8/) (ideally using your OS package manager) +1. Install [virtualenv](https://virtualenv.pypa.io/en/stable/) (ideally using your OS package manager) +1. Create a virtualenv for the Buildbot slave: `virtualenv /path/to/environment` +1. Install the Buildbot slave software and dependencies in the virtualenv: `/path/to/environment/bin/pip install buildbot-slave==0.8.14` +1. Use `buildslave` and `buildbot` commands from `/path/to/environment/bin/` in the steps detailed below to configure and start your buildslave (activate the virtualenv to put them on your `$PATH`: `. /path/to/environment/bin/activate`). A buildslave makes TCP connections to the buildmaster, which `tahoe-lafs.org` operates. You do not need a publicly routable IP address. @@ -20,7 +21,7 @@ Choose a name for your buildslave which will fit into the list of buildslave nam It should follow the pattern "YourName OperatingSystemAndVersion py2.x" -- see [existing buildslave names](https://tahoe-lafs.org/buildbot-tahoe-lafs/builders) for examples. ## Get a Password -Email Brian (warner-tahoe_at_lothar_dot_com) and ask for a password. +Email Tahoe-Dev (tahoe-dev_at_tahoe_-_lafs_dot_org) with your slave name and ask for a password. ## Create a Buildslave Execute the following commands: