<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Configuration — Buildbot 0.8.12 documentation</title>
<link rel="stylesheet" href="../_static/agogo.css" type="text/css" />
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: '../',
VERSION: '0.8.12',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<link rel="shortcut icon" href="../_static/buildbot.ico"/>
<link rel="top" title="Buildbot 0.8.12 documentation" href="../index.html" />
<link rel="up" title="Buildbot Manual" href="index.html" />
<link rel="next" title="Configuring Buildbot" href="cfg-intro.html" />
<link rel="prev" title="Concepts" href="concepts.html" />
</head>
<body role="document">
<div class="header-wrapper" role="banner">
<div class="header">
<p class="logo"><a href="../index.html">
<img class="logo" src="../_static/header-text-transparent.png" alt="Logo"/>
</a></p>
<div class="headertitle"><a
href="../index.html">Buildbot 0.8.12 documentation</a></div>
<div class="rel" role="navigation" aria-label="related navigation">
<a href="concepts.html" title="Concepts"
accesskey="P">previous</a> |
<a href="cfg-intro.html" title="Configuring Buildbot"
accesskey="N">next</a> |
<a href="../py-modindex.html" title="Python Module Index"
>modules</a> |
<a href="../genindex.html" title="General Index"
accesskey="I">index</a>
</div>
</div>
</div>
<div class="content-wrapper">
<div class="content">
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<div class="section" id="configuration">
<span id="id1"></span><h1>Configuration<a class="headerlink" href="#configuration" title="Permalink to this headline">ΒΆ</a></h1>
<p>The following sections describe the configuration of the various Buildbot components.
The information available here is sufficient to create basic build and test configurations, and does not assume great familiarity with Python.</p>
<p>In more advanced Buildbot configurations, Buildbot acts as a framework for a continuous-integration application.
The next section, <a class="reference internal" href="customization.html"><span class="doc">Customization</span></a>, describes this approach, with frequent references into the <a class="reference internal" href="../developer/index.html#buildbot-development"><span class="std std-ref">development documentation</span></a>.</p>
<div class="toctree-wrapper compound">
<ul>
<li class="toctree-l1"><a class="reference internal" href="cfg-intro.html">Configuring Buildbot</a><ul>
<li class="toctree-l2"><a class="reference internal" href="cfg-intro.html#config-file-format">Config File Format</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-intro.html#predefined-config-file-symbols">Predefined Config File Symbols</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-intro.html#testing-the-config-file">Testing the Config File</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-intro.html#loading-the-config-file">Loading the Config File</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="cfg-global.html">Global Configuration</a><ul>
<li class="toctree-l2"><a class="reference internal" href="cfg-global.html#database-specification">Database Specification</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-global.html#multi-master-mode">Multi-master mode</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-global.html#site-definitions">Site Definitions</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-global.html#log-handling">Log Handling</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-global.html#data-lifetime">Data Lifetime</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-global.html#merging-build-requests">Merging Build Requests</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-global.html#prioritizing-builders">Prioritizing Builders</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-global.html#setting-the-pb-port-for-slaves">Setting the PB Port for Slaves</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-global.html#defining-global-properties">Defining Global Properties</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-global.html#debug-options">Debug Options</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-global.html#manhole">Manhole</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-global.html#metrics-options">Metrics Options</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-global.html#users-options">Users Options</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-global.html#input-validation">Input Validation</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-global.html#revision-links">Revision Links</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-global.html#codebase-generator">Codebase Generator</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="cfg-changesources.html">Change Sources</a><ul>
<li class="toctree-l2"><a class="reference internal" href="cfg-changesources.html#choosing-a-change-source">Choosing a Change Source</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-changesources.html#configuring-change-sources">Configuring Change Sources</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-changesources.html#mail-parsing-changesources">Mail-parsing ChangeSources</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-changesources.html#pbchangesource">PBChangeSource</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-changesources.html#p4source">P4Source</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-changesources.html#bonsaipoller">BonsaiPoller</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-changesources.html#svnpoller">SVNPoller</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-changesources.html#bzr-poller">Bzr Poller</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-changesources.html#gitpoller">GitPoller</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-changesources.html#hgpoller">HgPoller</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-changesources.html#bitbucketpullrequestpoller">BitbucketPullrequestPoller</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-changesources.html#gerritchangesource">GerritChangeSource</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-changesources.html#gerritchangefilter">GerritChangeFilter</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-changesources.html#change-hooks-http-notifications">Change Hooks (HTTP Notifications)</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-changesources.html#googlecodeatompoller">GoogleCodeAtomPoller</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="cfg-schedulers.html">Schedulers</a><ul>
<li class="toctree-l2"><a class="reference internal" href="cfg-schedulers.html#configuring-schedulers">Configuring Schedulers</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-schedulers.html#change-filters">Change Filters</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-schedulers.html#singlebranchscheduler">SingleBranchScheduler</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-schedulers.html#anybranchscheduler">AnyBranchScheduler</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-schedulers.html#dependent-scheduler">Dependent Scheduler</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-schedulers.html#periodic-scheduler">Periodic Scheduler</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-schedulers.html#nightly-scheduler">Nightly Scheduler</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-schedulers.html#try-schedulers">Try Schedulers</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-schedulers.html#triggerable-scheduler">Triggerable Scheduler</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-schedulers.html#nightlytriggerable-scheduler">NightlyTriggerable Scheduler</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-schedulers.html#forcescheduler-scheduler">ForceScheduler Scheduler</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="cfg-buildslaves.html">Buildslaves</a><ul>
<li class="toctree-l2"><a class="reference internal" href="cfg-buildslaves.html#defining-buildslaves">Defining Buildslaves</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-buildslaves.html#buildslave-options">BuildSlave Options</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-buildslaves.html#latent-buildslaves">Latent Buildslaves</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="cfg-builders.html">Builder Configuration</a><ul>
<li class="toctree-l2"><a class="reference internal" href="cfg-builders.html#merging-build-requests">Merging Build Requests</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-builders.html#prioritizing-builds">Prioritizing Builds</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="cfg-buildfactories.html">Build Factories</a><ul>
<li class="toctree-l2"><a class="reference internal" href="cfg-buildfactories.html#defining-a-build-factory">Defining a Build Factory</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-buildfactories.html#predefined-build-factories">Predefined Build Factories</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="cfg-properties.html">Properties</a><ul>
<li class="toctree-l2"><a class="reference internal" href="cfg-properties.html#common-build-properties">Common Build Properties</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-properties.html#source-stamp-attributes">Source Stamp Attributes</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-properties.html#using-properties-in-steps">Using Properties in Steps</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="cfg-buildsteps.html">Build Steps</a><ul>
<li class="toctree-l2"><a class="reference internal" href="cfg-buildsteps.html#common-parameters">Common Parameters</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-buildsteps.html#module-buildbot.steps.source">Source Checkout</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-buildsteps.html#source-checkout-slave-side">Source Checkout (Slave-Side)</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-buildsteps.html#shellcommand">ShellCommand</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-buildsteps.html#slave-filesystem-steps">Slave Filesystem Steps</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-buildsteps.html#python-buildsteps">Python BuildSteps</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-buildsteps.html#transferring-files">Transferring Files</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-buildsteps.html#transfering-strings">Transfering Strings</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-buildsteps.html#running-commands-on-the-master">Running Commands on the Master</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-buildsteps.html#setting-properties">Setting Properties</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-buildsteps.html#setting-buildslave-info">Setting Buildslave Info</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-buildsteps.html#triggering-schedulers">Triggering Schedulers</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-buildsteps.html#rpm-related-steps">RPM-Related Steps</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-buildsteps.html#debian-build-steps">Debian Build Steps</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-buildsteps.html#miscellaneous-buildsteps">Miscellaneous BuildSteps</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="cfg-interlocks.html">Interlocks</a><ul>
<li class="toctree-l2"><a class="reference internal" href="cfg-interlocks.html#access-modes">Access Modes</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-interlocks.html#count">Count</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-interlocks.html#scope">Scope</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-interlocks.html#examples">Examples</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="cfg-statustargets.html">Status Targets</a><ul>
<li class="toctree-l2"><a class="reference internal" href="cfg-statustargets.html#webstatus">WebStatus</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-statustargets.html#mailnotifier">MailNotifier</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-statustargets.html#irc-bot">IRC Bot</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-statustargets.html#pblistener">PBListener</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-statustargets.html#statuspush">StatusPush</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-statustargets.html#httpstatuspush">HttpStatusPush</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-statustargets.html#gerritstatuspush">GerritStatusPush</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-statustargets.html#githubstatus">GitHubStatus</a></li>
<li class="toctree-l2"><a class="reference internal" href="cfg-statustargets.html#stashstatuspush">StashStatusPush</a></li>
</ul>
</li>
</ul>
</div>
</div>
</div>
</div>
</div>
</div>
<div class="sidebar">
<h3>Table Of Contents</h3>
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="../tutorial/index.html">Buildbot Tutorial</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="index.html">Buildbot Manual</a><ul class="current">
<li class="toctree-l2"><a class="reference internal" href="introduction.html">Introduction</a></li>
<li class="toctree-l2"><a class="reference internal" href="installation.html">Installation</a></li>
<li class="toctree-l2"><a class="reference internal" href="concepts.html">Concepts</a></li>
<li class="toctree-l2 current"><a class="current reference internal" href="#">Configuration</a><ul>
<li class="toctree-l3"><a class="reference internal" href="cfg-intro.html">Configuring Buildbot</a></li>
<li class="toctree-l3"><a class="reference internal" href="cfg-global.html">Global Configuration</a></li>
<li class="toctree-l3"><a class="reference internal" href="cfg-changesources.html">Change Sources</a></li>
<li class="toctree-l3"><a class="reference internal" href="cfg-schedulers.html">Schedulers</a></li>
<li class="toctree-l3"><a class="reference internal" href="cfg-buildslaves.html">Buildslaves</a></li>
<li class="toctree-l3"><a class="reference internal" href="cfg-builders.html">Builder Configuration</a></li>
<li class="toctree-l3"><a class="reference internal" href="cfg-buildfactories.html">Build Factories</a></li>
<li class="toctree-l3"><a class="reference internal" href="cfg-properties.html">Properties</a></li>
<li class="toctree-l3"><a class="reference internal" href="cfg-buildsteps.html">Build Steps</a></li>
<li class="toctree-l3"><a class="reference internal" href="cfg-interlocks.html">Interlocks</a></li>
<li class="toctree-l3"><a class="reference internal" href="cfg-statustargets.html">Status Targets</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="customization.html">Customization</a></li>
<li class="toctree-l2"><a class="reference internal" href="new-style-steps.html">New-Style Build Steps</a></li>
<li class="toctree-l2"><a class="reference internal" href="cmdline.html">Command-line Tool</a></li>
<li class="toctree-l2"><a class="reference internal" href="resources.html">Resources</a></li>
<li class="toctree-l2"><a class="reference internal" href="optimization.html">Optimization</a></li>
<li class="toctree-l2"><a class="reference internal" href="plugins.html">Plugin Infrastructure in Buildbot</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../developer/index.html">Buildbot Development</a></li>
<li class="toctree-l1"><a class="reference internal" href="../relnotes/index.html">Release Notes for Buildbot 0.8.12</a></li>
</ul>
<div role="search">
<h3 style="margin-top: 1.5em;">Search</h3>
<form class="search" action="../search.html" method="get">
<input type="text" name="q" />
<input type="submit" value="Go" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div>
<div class="clearer"></div>
</div>
</div>
<div class="footer-wrapper">
<div class="footer">
<div class="left">
<div role="navigation" aria-label="related navigaton">
<a href="concepts.html" title="Concepts"
>previous</a> |
<a href="cfg-intro.html" title="Configuring Buildbot"
>next</a> |
<a href="../py-modindex.html" title="Python Module Index"
>modules</a> |
<a href="../genindex.html" title="General Index"
>index</a>
</div>
<div role="note" aria-label="source link">
<br/>
<a href="../_sources/manual/configuration.txt"
rel="nofollow">Show Source</a>
</div>
</div>
<div class="right">
<div class="footer" role="contentinfo">
© Copyright Buildbot Team Members.
Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.4.1.
</div>
</div>
<div class="clearer"></div>
</div>
</div>
</body>
</html>
