Changes between Initial Version and Version 1 of BuildBot


Ignore:
Timestamp:
Nov 6, 2006 2:37:04 PM (14 years ago)
Author:
bdash@webkit.org
Comment:

Import of BuildBot instrutions

Legend:

Unmodified
Added
Removed
Modified
  • BuildBot

    v1 v1  
     1= WebKit BuildBot =
     2
     3The WebKit BuildBot is a system to help automate the compile/test cycle. After every commit to WebKit's Subversion repository it will schedule compilation and tests on a variety of different computers, known as build slaves.
     4
     5
     6== Running a Build Slave ==
     7
     8Each build slave needs a unique username and password to be able to take part in the compile/test cycle. Please email [mailto:bdash@webkit.org bdash] if you would like to contribute a build slave.
     9
     10Please ensure that you are familiar with building WebKit from source so that problems getting the slave up and running can be easily troubleshooted. The machine will need to have:
     11
     12 * Xcode 2.4 (or greater) installed.
     13 * Subversion installed and accessible on the `PATH`.
     14 * the Ahem font installed.
     15 * If possible, set the computer to not go to sleep (under Energy Saver in System Preferences)
     16
     17=== Installing BuildBot and Dependencies ===
     18
     19 1. Install Twisted
     20    1. Download Twisted.
     21    1. Extract it.
     22    1. In a shell, change into the `TwistedSumo-2005-11-06/ZopeInterface-3.1.0c1` directory and run `sudo python setup.py install`
     23    1. Change back up to the `TwistedSumo-2005-11-06` directory and run `sudo python setup.py install`
     24 1. Install BuildBot
     25    1. Download BuildBot.
     26    1. Extract it.
     27    1. In a shell, change into the `buildbot` directory and run `sudo python setup.py install`
     28
     29=== Configuring a Build Slave ===
     30
     31 1. Open a shell inside a directory suitable to keep the build slaves copy of the WebKit repository
     32 1. Add `/System/Library/Frameworks/Python.framework/Versions/2.3/bin/` to your shell's `PATH` variable.
     33 1. Run `buildbot slave WebKit-BuildSlave build.webkit.org:9989 [username] [password]`
     34 1. Change to the `WebKit-BuildSlave` directory
     35 1. Rename `Makefile.sample` to `Makefile`
     36 1. Edit `info/admin` and `info/host` to contain basic contact information and information about the build slave.
     37 1. Run `make start` to start the build slave.  Logging information can be viewed by running make log.
     38 1. Generate an ssh (dsa) key pair and send `id_dsa.pub` to bdash to allow the machine to upload build results.
     39 1. Once you recieve login information from bdash, ssh once to buildbot master, thus adding an entry to your knownhosts file (prevents upload script from later hanging).