<!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>Release Notes for Buildbot v0.8.6p1 — Buildbot 0.8.9 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.9',
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.9 documentation" href="../index.html" />
<link rel="up" title="Release Notes for Buildbot 0.8.9" href="index.html" />
<link rel="prev" title="Release Notes for Buildbot v0.8.7" href="0.8.7.html" />
</head>
<body>
<div class="header-wrapper">
<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.9 documentation</a></div>
<div class="rel">
<a href="0.8.7.html" title="Release Notes for Buildbot v0.8.7"
accesskey="P">previous</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">
<div class="section" id="release-notes-for-buildbot-v0-8-6p1">
<h1>Release Notes for Buildbot v0.8.6p1<a class="headerlink" href="#release-notes-for-buildbot-v0-8-6p1" title="Permalink to this headline">¶</a></h1>
<p>The following are the release notes for Buildbot v0.8.6p1.
Buildbot v0.8.6 was released on March 11, 2012.
Buildbot v0.8.6p1 was released on March 25, 2012.</p>
<div class="section" id="p1">
<h2>0.8.6p1<a class="headerlink" href="#p1" title="Permalink to this headline">¶</a></h2>
<p>In addition to what's listed below, the 0.8.6p1 release adds the following.</p>
<ul class="simple">
<li>Builders are no longer displayed in the order they were configured. This was
never intended behavior, and will become impossible in the distributed
architecture planned for Buildbot-0.9.x. As of 0.8.6p1, builders are sorted
naturally: lexically, but with numeric segments sorted numerically.</li>
<li>Slave properties in the configuration are now handled correctly.</li>
<li>The web interface buttons to cancel individual builds now appear when
configured.</li>
<li>The ForceScheduler's properties are correctly updated on reconfig -
<a class="reference external" href="http://trac.buildbot.net/ticket/2248" title="bug #2248">bug #2248</a>.</li>
<li>If a slave is lost while waiting for locks, it is properly cleaned up -
<a class="reference external" href="http://trac.buildbot.net/ticket/2247" title="bug #2247">bug #2247</a>.</li>
<li>Crashes when adding new steps to a factory in a reconfig are fixed -
<a class="reference external" href="http://trac.buildbot.net/ticket/2252" title="bug #2252">bug #2252</a>.</li>
<li>MailNotifier AttributeErrors are fixed - <a class="reference external" href="http://trac.buildbot.net/ticket/2254" title="bug #2254">bug #2254</a>.</li>
<li>Cleanup from failed builds is improved - <a class="reference external" href="http://trac.buildbot.net/ticket/2253" title="bug #2253">bug #2253</a>.</li>
</ul>
</div>
<div class="section" id="master">
<h2>Master<a class="headerlink" href="#master" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>If you are using the GitHub hook, carefully consider the security
implications of allowing un-authenticated change requests, which can
potentially build arbitrary code. See <a class="reference external" href="http://trac.buildbot.net/ticket/2186" title="bug #2186">bug #2186</a>.</li>
</ul>
<div class="section" id="deprecations-removals-and-non-compatible-changes">
<h3>Deprecations, Removals, and Non-Compatible Changes<a class="headerlink" href="#deprecations-removals-and-non-compatible-changes" title="Permalink to this headline">¶</a></h3>
<ul>
<li><p class="first">Forced builds now require that a <a class="reference internal" href="../manual/cfg-schedulers.html#sched-ForceScheduler" title="ForceScheduler"><tt class="xref bb bb-sched docutils literal"><span class="pre">ForceScheduler</span></tt></a> be defined in the
Buildbot configuration. For compatible behavior, this should look like:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="kn">from</span> <span class="nn">buildbot.schedulers.forcesched</span> <span class="kn">import</span> <span class="n">ForceScheduler</span>
<span class="n">c</span><span class="p">[</span><span class="s">'schedulers'</span><span class="p">]</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">ForceScheduler</span><span class="p">(</span>
<span class="n">name</span><span class="o">=</span><span class="s">"force"</span><span class="p">,</span>
<span class="n">builderNames</span><span class="o">=</span><span class="p">[</span><span class="s">"b1"</span><span class="p">,</span> <span class="s">"b2"</span><span class="p">,</span> <span class="o">...</span> <span class="p">]))</span>
</pre></div>
</div>
<p>Where all of the builder names in the configuration are listed. See the
documentation for the <em>much</em> more flexiblie configuration options now
available.</p>
</li>
<li><p class="first">This is the last release of Buildbot that will be compatible with Python 2.4.
The next version will minimally require Python-2.5. See <a class="reference external" href="http://trac.buildbot.net/ticket/2157" title="bug #2157">bug #2157</a>.</p>
</li>
<li><p class="first">This is the last release of Buildbot that will be compatible with
Twisted-8.x.y. The next version will minimally require Twisted-9.0.0. See
<a class="reference external" href="http://trac.buildbot.net/ticket/2182" title="bug #2182">bug #2182</a>.</p>
</li>
<li><p class="first"><tt class="docutils literal"><span class="pre">buildbot</span> <span class="pre">start</span></tt> no longer invokes make if a <tt class="docutils literal"><span class="pre">Makefile.buildbot</span></tt> exists.
If you are using this functionality, consider invoking make directly.</p>
</li>
<li><p class="first">The <tt class="docutils literal"><span class="pre">buildbot</span> <span class="pre">sendchange</span></tt> option <tt class="docutils literal"><span class="pre">--username</span></tt> has been removed as
promised in <a class="reference external" href="http://trac.buildbot.net/ticket/1711" title="bug #1711">bug #1711</a>.</p>
</li>
<li><p class="first">StatusReceivers' checkConfig method should now take an additional <cite>errors</cite>
parameter and call its <a class="reference internal" href="../developer/config.html#buildbot.config.ConfigErrors.addError" title="buildbot.config.ConfigErrors.addError"><tt class="xref py py-meth docutils literal"><span class="pre">addError</span></tt></a>
method to indicate errors.</p>
</li>
<li><p class="first">The gerrit status callback now gets an additional parameter (the master
status). If you use this callback, you will need to adjust its
implementation.</p>
</li>
<li><p class="first">SQLAlchemy-Migrate version 0.6.0 is no longer supported. See
<a class="reference internal" href="../manual/installation.html#buildmaster-requirements"><em>Buildmaster Requirements</em></a>.</p>
</li>
<li><p class="first">Older versions of SQLite which could limp along for previous versions of
Buildbot are no longer supported. The minimum version is 3.4.0, and 3.7.0 or
higher is recommended.</p>
</li>
<li><p class="first">The master-side Git step now checks out 'HEAD' by default, rather than
master, which translates to the default branch on the upstream repository. See
<a class="reference external" href="https://github.com/buildbot/buildbot/pull/301" title="pull request 301">pull request 301</a>.</p>
</li>
<li><p class="first">The format of the repository strings created by <tt class="docutils literal"><span class="pre">hgbuildbot</span></tt> has changed to
contain the entire repository URL, based on the <tt class="docutils literal"><span class="pre">web.baseurl</span></tt> value in
<tt class="docutils literal"><span class="pre">hgrc</span></tt>. To continue the old (incorrect) behavior, set
<tt class="docutils literal"><span class="pre">hgbuildbot.baseurl</span></tt> to an empty string as suggested in the Buildbot
manual.</p>
</li>
<li><p class="first">Master Side <a class="reference internal" href="../manual/cfg-buildsteps.html#step-SVN" title="SVN"><tt class="xref bb bb-step docutils literal"><span class="pre">SVN</span></tt></a> Step has been corrected to properly use
<tt class="docutils literal"><span class="pre">--revision</span></tt> when <tt class="docutils literal"><span class="pre">alwaysUseLatest</span></tt> is set to <tt class="docutils literal"><span class="pre">False</span></tt> when in the
<tt class="docutils literal"><span class="pre">full</span></tt> mode. See <a class="reference external" href="http://trac.buildbot.net/ticket/2194" title="bug #2194">bug #2194</a></p>
</li>
<li><p class="first">Master Side <a class="reference internal" href="../manual/cfg-buildsteps.html#step-SVN" title="SVN"><tt class="xref bb bb-step docutils literal"><span class="pre">SVN</span></tt></a> Step paramater svnurl has been renamed repourl, to
be consistent with other master-side source steps.</p>
</li>
<li><p class="first">Master Side <a class="reference internal" href="../manual/cfg-buildsteps.html#step-Mercurial" title="Mercurial"><tt class="xref bb bb-step docutils literal"><span class="pre">Mercurial</span></tt></a> step parameter <tt class="docutils literal"><span class="pre">baseURL</span></tt> has been merged
with <tt class="docutils literal"><span class="pre">repourl</span></tt> parameter. The behavior of the step is already controled by
<tt class="docutils literal"><span class="pre">branchType</span></tt> parameter, so just use a single argument to specify the repository.</p>
</li>
<li><p class="first">Passing a <a class="reference internal" href="../developer/cls-buildsteps.html#buildbot.process.buildstep.BuildStep" title="buildbot.process.buildstep.BuildStep"><tt class="xref py py-class docutils literal"><span class="pre">buildbot.process.buildstep.BuildStep</span></tt></a> subclass (rather than
instance) to <tt class="xref py py-meth docutils literal"><span class="pre">buildbot.process.factory.BuildFactory.addStep</span></tt> has long been
deprecated, and will be removed in version 0.8.7.</p>
</li>
<li><p class="first">The <cite>hgbuildbot</cite> tool now defaults to the 'inrepo' branch type. Users who do
not explicitly set a branch type would previously have seen empty branch strings,
and will now see a branch string based on the branch in the repository (e.g.,
<cite>default</cite>).</p>
</li>
</ul>
</div>
<div class="section" id="changes-for-developers">
<h3>Changes for Developers<a class="headerlink" href="#changes-for-developers" title="Permalink to this headline">¶</a></h3>
<ul class="simple">
<li>The interface for runtime access to the master's configuration has changed
considerably. See <a class="reference internal" href="../developer/config.html"><em>Configuration</em></a> for more details.</li>
<li>The DB connector methods <tt class="docutils literal"><span class="pre">completeBuildset</span></tt>, <tt class="docutils literal"><span class="pre">completeBuildRequest</span></tt>, and
<tt class="docutils literal"><span class="pre">claimBuildRequest</span></tt> now take an optional <tt class="docutils literal"><span class="pre">complete_at</span></tt> parameter to
specify the completion time explicitly.</li>
<li>Buildbot now sports sourcestamp sets, which collect multiple sourcestamps
used to generate a single build, thanks to Harry Borkhuis. See
<a class="reference external" href="https://github.com/buildbot/buildbot/pull/287" title="pull request 287">pull request 287</a>.</li>
<li>Schedulers no longer have a <tt class="docutils literal"><span class="pre">schedulerid</span></tt>, but rather an <tt class="docutils literal"><span class="pre">objectid</span></tt>. In
a related change, the <tt class="docutils literal"><span class="pre">schedulers</span></tt> table has been removed, along with the
<tt class="xref py py-meth docutils literal"><span class="pre">buildbot.db.schedulers.SchedulersConnectorComponent.getSchedulerId</span></tt>
method.</li>
<li>The Dependent scheduler tracks its upstream buildsets using
<tt class="xref py py-class docutils literal"><span class="pre">buildbot.db.schedulers.StateConnectorComponent</span></tt>, so the
<tt class="docutils literal"><span class="pre">scheduler_upstream_buildsets</span></tt> table has been removed, along with
corresponding (undocumented)
<tt class="xref py py-class docutils literal"><span class="pre">buildbot.db.buildsets.BuildsetsConnector</span></tt> methods.</li>
<li>Errors during configuration (in particular in <tt class="xref py py-class docutils literal"><span class="pre">BuildStep</span></tt> constructors),
should be reported by calling <a class="reference internal" href="../developer/config.html#buildbot.config.error" title="buildbot.config.error"><tt class="xref py py-func docutils literal"><span class="pre">buildbot.config.error</span></tt></a>.</li>
</ul>
</div>
<div class="section" id="features">
<h3>Features<a class="headerlink" href="#features" title="Permalink to this headline">¶</a></h3>
<ul>
<li><p class="first">The IRC status bot now display build status in colors by default.
It is controllable and may be disabled with useColors=False in constructor.</p>
</li>
<li><p class="first">Buildbot can now take advantage of authentication done by a front-end web
server - see <a class="reference external" href="https://github.com/buildbot/buildbot/pull/266" title="pull request 266">pull request 266</a>.</p>
</li>
<li><p class="first">Buildbot supports a simple cookie-based login system, so users no longer need
to enter a username and password for every request. See the earlier commits
in <a class="reference external" href="https://github.com/buildbot/buildbot/pull/278" title="pull request 278">pull request 278</a>.</p>
</li>
<li><p class="first">The master-side SVN step now has an <cite>export</cite> method which is similar to
<cite>copy</cite>, but the build directory does not contain Subversion metdata. (<a class="reference external" href="http://trac.buildbot.net/ticket/2078" title="bug #2078">bug #2078</a>)</p>
</li>
<li><p class="first"><tt class="xref py py-class docutils literal"><span class="pre">Property</span></tt> instances will now render any properties in the
default value if necessary. This makes possible constructs like</p>
<div class="highlight-python"><div class="highlight"><pre><span class="n">command</span><span class="o">=</span><span class="n">Property</span><span class="p">(</span><span class="s">'command'</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="n">Property</span><span class="p">(</span><span class="s">'default-command'</span><span class="p">))</span>
</pre></div>
</div>
</li>
<li><p class="first">Buildbot has a new web hook to handle push notifications from Google Code -
see <a class="reference external" href="https://github.com/buildbot/buildbot/pull/278" title="pull request 278">pull request 278</a>.</p>
</li>
<li><p class="first">Revision links are now generated by a flexible runtime conversion configured
by <a class="reference internal" href="../manual/cfg-global.html#cfg-revlink" title="revlink"><tt class="xref bb bb-cfg docutils literal"><span class="pre">revlink</span></tt></a> - see <a class="reference external" href="https://github.com/buildbot/buildbot/pull/280" title="pull request 280">pull request 280</a>.</p>
</li>
<li><p class="first">Shell command steps will now "flatten" nested lists in the <tt class="docutils literal"><span class="pre">command</span></tt>
argument. This allows substitution of multiple command-line arguments using
properties. See <a class="reference external" href="http://trac.buildbot.net/ticket/2150" title="bug #2150">bug #2150</a>.</p>
</li>
<li><p class="first">Steps now take an optional <tt class="docutils literal"><span class="pre">hideStepIf</span></tt> parameter to suppress the step
from the waterfall and build details in the web. (<a class="reference external" href="http://trac.buildbot.net/ticket/1743" title="bug #1743">bug #1743</a>)</p>
</li>
<li><p class="first"><tt class="xref py py-class docutils literal"><span class="pre">Trigger</span></tt> steps with <tt class="docutils literal"><span class="pre">waitForFinish=True</span></tt> now receive a URL to
all the triggered builds. This URL is displayed in the waterfall and build
details. See <a class="reference external" href="http://trac.buildbot.net/ticket/2170" title="bug #2170">bug #2170</a>.</p>
</li>
<li><p class="first">The <a class="reference external" href="https://github.com/buildbot/buildbot/blob/master/master/contrib/fakemaster.py`" title="master/contrib/fakemaster.py`"><tt class="docutils literal"><span class="pre">master/contrib/fakemaster.py`</span></tt></a> script allows you to run arbitrary
commands on a slave by emulating a master. See the file itself for
documentation.</p>
</li>
<li><p class="first">MailNotifier allows multiple notification modes in the same instance. See
<a class="reference external" href="http://trac.buildbot.net/ticket/2205" title="bug #2205">bug #2205</a>.</p>
</li>
<li><p class="first">SVNPoller now allows passing extra arguments via argument <tt class="docutils literal"><span class="pre">extra_args</span></tt>.
See <a class="reference external" href="http://trac.buildbot.net/ticket/1766" title="bug #1766">bug #1766</a></p>
</li>
</ul>
</div>
</div>
<div class="section" id="slave">
<h2>Slave<a class="headerlink" href="#slave" title="Permalink to this headline">¶</a></h2>
<div class="section" id="id1">
<h3>Deprecations, Removals, and Non-Compatible Changes<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h3>
<ul class="simple">
<li>BitKeeper support is in the "Last-Rites" state, and will be removed in the
next version unless a maintainer steps forward.</li>
</ul>
</div>
<div class="section" id="id2">
<h3>Features<a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h3>
</div>
</div>
<div class="section" id="details">
<h2>Details<a class="headerlink" href="#details" title="Permalink to this headline">¶</a></h2>
<p>For a more detailed description of the changes made in this version, see the
Git log itself:</p>
<div class="highlight-bash"><div class="highlight"><pre>git log buildbot-0.8.5..buildbot-0.8.6
</pre></div>
</div>
</div>
<div class="section" id="older-versions">
<h2>Older Versions<a class="headerlink" href="#older-versions" title="Permalink to this headline">¶</a></h2>
<p>Release notes for older versions of Buildbot are available in the
<a class="reference external" href="https://github.com/buildbot/buildbot/blob/master/master/docs/release-notes/" title="master/docs/release-notes/"><tt class="docutils literal"><span class="pre">master/docs/release-notes/</span></tt></a> directory of the source tree, or in the archived
documentation for those versions at <a class="reference external" href="http://buildbot.net/buildbot/docs">http://buildbot.net/buildbot/docs</a>.</p>
</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"><a class="reference internal" href="../manual/index.html">Buildbot Manual</a></li>
<li class="toctree-l1"><a class="reference internal" href="../developer/index.html">Buildbot Development</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="index.html">Release Notes for Buildbot 0.8.9</a><ul class="current">
<li class="toctree-l2 current"><a class="reference internal" href="0.8.8.html">Release Notes for Buildbot v0.8.8</a><ul class="current">
<li class="toctree-l3"><a class="reference internal" href="0.8.7.html">Release Notes for Buildbot v0.8.7</a></li>
<li class="toctree-l3 current"><a class="current reference internal" href="">Release Notes for Buildbot v0.8.6p1</a><ul class="simple">
</ul>
</li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="0.8.7.html">Release Notes for Buildbot v0.8.7</a></li>
<li class="toctree-l2 current"><a class="current reference internal" href="">Release Notes for Buildbot v0.8.6p1</a><ul class="simple">
</ul>
</li>
</ul>
</li>
</ul>
<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>
<p class="searchtip" style="font-size: 90%">
Enter search terms or a module, class or function name.
</p>
</div>
<div class="clearer"></div>
</div>
</div>
<div class="footer-wrapper">
<div class="footer">
<div class="left">
<a href="0.8.7.html" title="Release Notes for Buildbot v0.8.7"
>previous</a> |
<a href="../py-modindex.html" title="Python Module Index"
>modules</a> |
<a href="../genindex.html" title="General Index"
>index</a>
<br/>
<a href="../_sources/relnotes/0.8.6.txt"
rel="nofollow">Show Source</a>
</div>
<div class="right">
<div class="footer">
© Copyright Buildbot Team Members.
Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.2.3.
</div>
</div>
<div class="clearer"></div>
</div>
</div>
</body>
</html>
