wiki:WikiStart

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

--

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!)

trac stuff

Trac is a minimalistic approach to web-based management of software projects. Its goal is to simplify effective tracking and handling of software issues, enhancements and overall progress.

All aspects of Trac have been designed with the single goal to help developers write great software while staying out of the way and imposing as little as possible on a team's established process and culture.

As all Wiki pages, this page is editable, this means that you can modify the contents of this page simply by using your web-browser. Simply click on the "Edit this page" link at the bottom of the page. WikiFormatting will give you a detailed description of available Wiki formatting commands.

"trac-admin yourenvdir initenv" created a new Trac environment, containing a default set of wiki pages and some sample data. This newly created environment also contains documentation to help you get started with your project.

You can use trac-admin to configure Trac to better fit your project, especially in regard to components, versions and milestones.

TracGuide is a good place to start.

Enjoy!
The Trac Team

Starting Points

For a complete list of local wiki pages, see TitleIndex.