= 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. You might like to look at some ScreenShots. == Download/Install == The current release is buildbot-0.7.5: [http://downloads.sourceforge.net/buildbot/buildbot-0.7.5.tar.gz tgz] ([http://downloads.sourceforge.net/buildbot/buildbot-0.7.5.tar.gz.sig sig]), [http://downloads.sourceforge.net/buildbot/buildbot-0.7.5.zip zip] ([http://downloads.sourceforge.net/buildbot/buildbot-0.7.5.zip.sig sig]) * From Source: * Download the latest version from the !SourceForge [https://sourceforge.net/project/showfiles.php?group_id=73177 download page]. * Run setup.py install as per the [/repos/release/README README]. * Read the UserManual about configuring your new buildbot. * The release is signed with [http://www.lothar.com/warner-gpg.html my GPG public key]. * With setuptools: run {{{easy_install buildbot}}} * Debian Users: install the 'buildbot' [http://packages.debian.org/buildbot package] from the 'unstable' or 'testing' distribution. * Ubuntu Users: install the 'buildbot' [http://packages.ubuntu.com/buildbot package] from the Dapper 'universe' section (version 0.7.2 in dapper, 0.7.4 in edgy). (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/ . There is also [http://en.opensuse.org/Build_Service/User user documentation] available. * RPM Users: see [wiki:SourceRPMS Building RPMs] to produce RPMs for your Linux distribution, including RHEL/CentOS and Fedora. * Darwin Users: run port install buildbot (thanks to Olivier Bonnet for [http://bugzilla.opendarwin.org/show_bug.cgi?id=8888 making this happen]!) * Solaris Users: you have to install buildbot from source yourself, but Matthew Flanagan has written a [http://wadofstuff.blogspot.com/2007/01/smf-manifest-for-buildbot.html Solaris 10 SMF manifest] which will help automatically launch the buildmaster or buildslave as a Solaris service. == Configuration/Usage == * The [/repos/release/README README] file contains an overview. * The [UserManual User's Manual] contains complete documentation. * The [/repos/release/docs/reference/index.html API Reference] may be useful when writing the configuration file: the various Steps and Schedulers are documented there. * Recent changes for each release are summarized in the [/repos/release/NEWS NEWS] file, while the complete details are in the [/repos/release/ChangeLog ChangeLog]. * The Buildbot was first announced at [http://www.pycon.org PyCon] [http://us.pycon.org/zope/original/pycon/pastevents/dc2003 2003], where I delivered a [http://buildbot.sf.net/PyCon-2003/buildbot.html paper] along with some [http://buildbot.sf.net/PyCon-2003/slides/slide-00.html slides]. * BuildbotAndTrac describes some ways to combine a Buildbot with a Trac instance. == Support == * The [https://sourceforge.net/projects/buildbot/ SourceForge Project Page] contains bug trackers and archives of the mailing list. * Please join the [http://lists.sourceforge.net/lists/listinfo/buildbot-devel 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. * HelpfulPages contains a collection of articles and blog postings about Buildbot. * placeholder page for the BuildbotFaq is here * RunningBuildbotOnWindows == Development == * The latest pre-release code is available from CVS for [http://buildbot.cvs.sourceforge.net/buildbot/buildbot/ browsing] or [http://sourceforge.net/cvs/?group_id=73177 read-only checkout]. * or you can see the latest HEAD revision by using darcs to pull a tree from http://buildbot.net/repos/trunk * other work-in-progress branches are published to http://buildbot.net/repos/ * There are also [LatestBuildbotSource Arch and Darcs repositories] which track the main CVS tree and provide lower-latency access than anonymous CVS. * You might want to look at the CVS trunk version of the [/repos/trunk/docs/buildbot.html user's manual] to get an idea of what sorts of features are coming up in the next release. * You can also join the [http://lists.sourceforge.net/lists/listinfo/buildbot-commits buildbot-commits mailing list] to be notified about changes in CVS. * There is a brief [/trac/roadmap roadmap] listing goals for the next few releases. * FutureIdeas has some random thoughts on things that might make the Buildbot better. * placeholder pages for WritingBuildSteps and WritingStatusPlugins are here == Success Stories == Buildbots are installed in at least 100 sites all over the world. Users have submitted pointers to the SuccessStories page, so you can get a feel for how Buildbot is being used. Install a buildbot today and add your name! == Miscellaneous == Many thanks to sourceforge.net for hosting the buildbot's [https://sourceforge.net/projects/buildbot/ SourceForge Project Page] for all these years. {{{ #!html SourceForge.net Logo }}} The original TracStartingPage was moved away. If you'd like to edit these pages, please use the "Register" link at the top right corner of this page to create an account. I'd appreciate it if you'd add a useable email address when you do so (using the "Settings" link). If you do, you'll receive email when tickets that you have filed are updated or closed, and you can add your name as a cc: on tickets that you're interested in.