How to check out and run the Skia Buildbot

originally written by epoger@google.com on 17 June 2011
updated 20 July 2011

Prerequisites

depot_tools : you will need to use gclient to check out the buildbot code

Check out the buildbot source

Use gclient to check out the buildbot source code. Buildbot, in turn, downloads its own copy of gclient (depot_tools), which you must run manually at least once to prepare for automated use later.

On Mac or Linux:

INSTALLDIR=/home/$USER/src/skia-buildbot    # or wherever you want to install it
cd $INSTALLDIR
gclient config https://skia.googlecode.com/svn/buildbot
gclient sync
buildbot/third_party/depot_tools/gclient --help

On Windows:

set INSTALLDIR=%HOMEPATH%\src\skia-buildbot
cd %INSTALLDIR%
gclient config https://skia.googlecode.com/svn/buildbot
gclient sync
buildbot\third_party\depot_tools\gclient --help

For Windows only: Due to http://code.google.com/p/chromium/issues/detail?id=89900 ('svn within depot_tools' svn_bin.zip fails for "svn --version" at Windows Command Prompt'), we now have a "gclient hooks" step that patches buildbot\third_party\depot_tools\gclient.bat to call your system-level gclient.bat. You may need to manually modify which version of svn.exe your system-level gclient.bat calls. For more info, see http://code.google.com/p/skia/source/browse/buildbot/hooks.py or contact epoger@google.com .

Start the buildbot master (on Linux)

cd $INSTALLDIR/buildbot/master
make restart

The first time you run a new installation of buildbot, you will probably see a message like this: The Buildmaster database needs to be upgraded before this version of buildbot can run. If so, run the following command to upgrade the database and then call make restart again:

make upgrade

Start the buildbot slave (on Linux or Mac)

Leave the master running in its window; open a new window and launch the slave as follows:

cd $INSTALLDIR/buildbot/slave   # be sure to set $INSTALLDIR first
make restart

Start the buildbot slave (on Windows)

Open a new window and launch the slave as follows:

cd %INSTALLDIR%\buildbot\slave
run_slave

Look at the results

Fire up a web browser and look at http://localhost:8041/console?reload=40