wiki:WikiStart

Version 5 (modified by warner, 11 years ago) (diff)

moved original welcome-to-trac page elsewhere

Welcome to Buildbot

The BuildBot is a system to automate the compile/test cycle required by most software projects to validate code changes. By automatically rebuilding and testing the tree each time something has changed, build problems are pinpointed quickly, before other developers are inconvenienced by the failure. The guilty developer can be identified and harassed without human intervention. By running the builds on a variety of platforms, developers who do not have the facilities to test their changes everywhere before checkin will at least know shortly afterwards whether they have broken the build or not. Warning counts, lint checks, image size, compile time, and other build parameters can be tracked over time, are more visible, and are therefore easier to improve.

The overall goal is to reduce tree breakage and provide a platform to run tests or code-quality checks that are too annoying or pedantic for any human to waste their time with. Developers get immediate (and potentially public) feedback about their changes, encouraging them to be more careful about testing before checkin.

Current contents:

  • The current release is buildbot-0.7.5 . You can download the source from the sf.net download page here. The release is signed with my GPG public key, available here.
  • The latest code is available from CVS for browsing or read-only checkout. There are also Arch and Darcs repositories which track the main CVS tree and provide lower-latency access than anonymous CVS, details are here. There is also a copy of the CVS user's manual available, which may give you an idea of what sorts of features are coming up in the next release.
  • The README file contains an overview, while the User's Manual contains complete documentation. The API Reference may be useful when writing the configuration file: the various Steps and Schedulers are documented there.
  • Recent changes are summarized in the NEWS file, while the complete details are in the ChangeLog?.
  • The paper delivered at PyCon?-2003, along with the slides.
  • The SourceForge? Project Page
  • Please join the buildbot-devel mailing list to be notified about new releases, discuss how to configure and use the buildbot, and to hear about new development. This is both a user and a developer mailing list.
  • You can also join the buildbot-commits mailing list to be notified about changes in CVS.
  • There is a brief roadmap listing goals for the next few releases.

Getting Buidlbot

  • From Source: download the latest version from the SourceForge? Project Page, run setup.py install as per the README, and read the User's Manual about configuring your new buildbot.
  • Debian Users: install the 'buildbot' package from the 'unstable' or 'testing' distribution.
  • Ubuntu Users: install the 'buildbot' package from the Dapper 'universe' distribution (version 0.7.2). (thanks to Matthias Klose for making both of these debian versions happen!). For newer versions, look for backports or install from source.
  • SUSE Users: Marcus Rueckert has made SUSE RPMs available at ‚Äčhttp://software.opensuse.org/download/devel:/tools:/building/ . Take a look here for user documentation.
  • Darwin Users: run port install buildbot (thanks to Olivier Bonnet for making this happen!)

The original TracStartingPage was moved away.