<!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.8 — 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="Release Notes for Buildbot 0.8.9" href="0.8.9.html" />
<link rel="next" title="Release Notes for Buildbot v0.8.7" href="0.8.7.html" />
<link rel="prev" title="Release Notes for Buildbot 0.8.9" href="0.8.9.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="0.8.9.html" title="Release Notes for Buildbot 0.8.9"
accesskey="P">previous</a> |
<a href="0.8.7.html" title="Release Notes for Buildbot v0.8.7"
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="release-notes-for-buildbot-v0-8-8">
<h1>Release Notes for Buildbot v0.8.8<a class="headerlink" href="#release-notes-for-buildbot-v0-8-8" title="Permalink to this headline">¶</a></h1>
<p>The following are the release notes for Buildbot v0.8.8
Buildbot v0.8.8 was released on August 22, 2013</p>
<div class="section" id="master">
<h2>Master<a class="headerlink" href="#master" title="Permalink to this headline">¶</a></h2>
<div class="section" id="features">
<h3>Features<a class="headerlink" href="#features" title="Permalink to this headline">¶</a></h3>
<ul class="simple">
<li>The <code class="docutils literal"><span class="pre">MasterShellCommand</span></code> step now correctly handles environment variables passed as list.</li>
<li>The master now poll the database for pending tasks when running buildbot in multi-master mode.</li>
<li>The algorithm to match build requests to slaves has been rewritten in <a class="reference external" href="https://github.com/buildbot/buildbot/pull/615" title="pull request 615">pull request 615</a>.
The new algorithm automatically takes locks into account, and will not schedule a build only to have it wait on a lock.
The algorithm also introduces a <code class="docutils literal"><span class="pre">canStartBuild</span></code> builder configuration option which can be used to prevent a build request being assigned to a slave.</li>
<li><code class="docutils literal"><span class="pre">buildbot</span> <span class="pre">stop</span></code> and <code class="docutils literal"><span class="pre">buildbot</span> <span class="pre">restart</span></code> now accept <code class="docutils literal"><span class="pre">--clean</span></code> to stop or restart the master cleanly (allowing all running builds to complete first).</li>
<li>The <a class="reference internal" href="../manual/cfg-statustargets.html#status-IRC" title="IRC"><code class="xref bb bb-status docutils literal"><span class="pre">IRC</span></code></a> bot now supports clean shutdown and immediate shutdown by using the command 'shutdown'.
To allow the command to function, you must provide <cite>allowShutdown=True</cite>.</li>
<li><a class="reference internal" href="../manual/cfg-buildsteps.html#step-CopyDirectory" title="CopyDirectory"><code class="xref bb bb-step docutils literal"><span class="pre">CopyDirectory</span></code></a> has been added.</li>
<li><a class="reference internal" href="../manual/cfg-schedulers.html#sched-BuildslaveChoiceParameter" title="BuildslaveChoiceParameter"><code class="xref bb bb-sched docutils literal"><span class="pre">BuildslaveChoiceParameter</span></code></a> has been added to provide a way to explicitly choose a buildslave
for a given build.</li>
<li>default.css now wraps preformatted text by default.</li>
<li>Slaves can now be paused through the web status.</li>
<li>The latent buildslave support is less buggy, thanks to <a class="reference external" href="https://github.com/buildbot/buildbot/pull/646" title="pull request 646">pull request 646</a>.</li>
<li>The <code class="docutils literal"><span class="pre">treeStableTimer</span></code> for <code class="docutils literal"><span class="pre">AnyBranchScheduler</span></code> now maintains separate timers for separate branches, codebases, projects, and repositories.</li>
<li><a class="reference internal" href="../manual/cfg-buildsteps.html#step-SVN" title="SVN"><code class="xref bb bb-step docutils literal"><span class="pre">SVN</span></code></a> has a new option <cite>preferLastChangedRev=True</cite> to use the last changed revision for <code class="docutils literal"><span class="pre">got_revision</span></code></li>
<li>The build request DB connector method <a class="reference internal" href="../developer/database.html#buildbot.db.buildrequests.BuildRequestsConnectorComponent.getBuildRequests" title="buildbot.db.buildrequests.BuildRequestsConnectorComponent.getBuildRequests"><code class="xref py py-meth docutils literal"><span class="pre">getBuildRequests</span></code></a> can now filter by branch and repository.</li>
<li>A new <a class="reference internal" href="../manual/cfg-buildsteps.html#step-SetProperty" title="SetProperty"><code class="xref bb bb-step docutils literal"><span class="pre">SetProperty</span></code></a> step has been added in <code class="docutils literal"><span class="pre">buildbot.steps.master</span></code> which can set a property directly without accessing the slave.</li>
<li>The new <a class="reference internal" href="../manual/cfg-buildsteps.html#step-LogRenderable" title="LogRenderable"><code class="xref bb bb-step docutils literal"><span class="pre">LogRenderable</span></code></a> step logs Python objects, which can contain renderables, to the logfile.
This is helpful for debugging property values during a build.</li>
<li>'buildbot try' now has an additional <code class="xref std std-option docutils literal"><span class="pre">--property</span></code> option to set properties.
Unlike the existing <code class="xref std std-option docutils literal"><span class="pre">--properties</span></code> option, this new option supports setting
only a single property and therefore allows commas to be included in the property
name and value.</li>
<li>The <code class="docutils literal"><span class="pre">Git</span></code> step has a new <code class="docutils literal"><span class="pre">config</span></code> option, which accepts a dict of git configuration options to
pass to the low-level git commands. See <a class="reference internal" href="../manual/cfg-buildsteps.html#step-Git" title="Git"><code class="xref bb bb-step docutils literal"><span class="pre">Git</span></code></a> for details.</li>
<li>In <a class="reference internal" href="../manual/cfg-buildsteps.html#step-ShellCommand" title="ShellCommand"><code class="xref bb bb-step docutils literal"><span class="pre">ShellCommand</span></code></a> ShellCommand now validates its arguments during config and will identify any invalid arguments before a build is started.</li>
<li>The list of force schedulers in the web UI is now sorted by name.</li>
<li>OpenStack-based Latent Buildslave support was added.
See <a class="reference external" href="https://github.com/buildbot/buildbot/pull/666" title="pull request 666">pull request 666</a>.</li>
<li>Master-side support for P4 is available, and provides a great deal more flexibility than the old slave-side step.
See <a class="reference external" href="https://github.com/buildbot/buildbot/pull/596" title="pull request 596">pull request 596</a>.</li>
<li>Master-side support for Repo is available.
The step parameters changed to camelCase.
<code class="docutils literal"><span class="pre">repo_downloads</span></code>, and <code class="docutils literal"><span class="pre">manifest_override_url</span></code> properties are no longer hardcoded, but instead consult as default values via renderables.
Renderable are used in favor of callables for <code class="docutils literal"><span class="pre">syncAllBranches</span></code> and <code class="docutils literal"><span class="pre">updateTarball</span></code>.</li>
<li>Builder configurations can now include a <code class="docutils literal"><span class="pre">description</span></code>, which will appear in the web UI to help humans figure out what the builder does.</li>
<li>GNUAutoconf and other pre-defined factories now work correctly (<a class="reference external" href="http://trac.buildbot.net/ticket/2402" title="bug #2402">bug #2402</a>)</li>
<li>The pubDate in RSS feeds is now rendered correctly (<a class="reference external" href="http://trac.buildbot.net/ticket/2530" title="bug #2530">bug #2530</a>)</li>
</ul>
</div>
<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 class="simple">
<li>The <code class="docutils literal"><span class="pre">split_file</span></code> function for <a class="reference internal" href="../manual/cfg-changesources.html#chsrc-SVNPoller" title="SVNPoller"><code class="xref bb bb-chsrc docutils literal"><span class="pre">SVNPoller</span></code></a> may now return a dictionary instead of a tuple.
This allows it to add extra information about a change (such as <code class="docutils literal"><span class="pre">project</span></code> or <code class="docutils literal"><span class="pre">repository</span></code>).</li>
<li>The <code class="docutils literal"><span class="pre">workdir</span></code> build property has been renamed to <code class="docutils literal"><span class="pre">builddir</span></code>.
This change accurately reflects its content; the term "workdir" means something different.
<code class="docutils literal"><span class="pre">workdir</span></code> is currently still supported for backwards compatability, but will be removed eventually.</li>
<li>The <code class="docutils literal"><span class="pre">Blocker</span></code> step has been removed.</li>
<li>Several polling ChangeSources are now documented to take a <code class="docutils literal"><span class="pre">pollInterval</span></code> argument, instead of <code class="docutils literal"><span class="pre">pollinterval</span></code>.
The old name is still supported.</li>
<li>StatusReceivers' checkConfig method should no longer take an <cite>errors</cite> parameter.
It should indicate errors by calling <a class="reference internal" href="../developer/config.html#buildbot.config.error" title="buildbot.config.error"><code class="xref py py-func docutils literal"><span class="pre">error</span></code></a>.</li>
<li>Build steps now require that their name be a string.
Previously, they would accept anything, but not behave appropriately.</li>
<li>The web status no longer displays a potentially misleading message, indicating whether the build
can be rebuilt exactly.</li>
<li>The <code class="docutils literal"><span class="pre">SetProperty</span></code> step in <code class="docutils literal"><span class="pre">buildbot.steps.shell</span></code> has been renamed to <a class="reference internal" href="../manual/cfg-buildsteps.html#step-SetPropertyFromCommand" title="SetPropertyFromCommand"><code class="xref bb bb-step docutils literal"><span class="pre">SetPropertyFromCommand</span></code></a>.</li>
<li>The EC2 and libvirt latent slaves have been moved to <code class="docutils literal"><span class="pre">buildbot.buildslave.ec2</span></code> and <code class="docutils literal"><span class="pre">buildbot.buildslave.libirt</span></code> respectively.</li>
<li>Pre v0.8.7 versions of buildbot supported passing keyword arguments to <code class="docutils literal"><span class="pre">buildbot.process.BuildFactory.addStep</span></code>, but this was dropped.
Support was added again, while still being deprecated, to ease transition.</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>Added an optional build start callback to <code class="docutils literal"><span class="pre">buildbot.status.status_gerrit.GerritStatusPush</span></code>
This release includes the fix for <a class="reference external" href="http://trac.buildbot.net/ticket/2536" title="bug #2536">bug #2536</a>.</li>
<li>An optional <code class="docutils literal"><span class="pre">startCB</span></code> callback to <a class="reference internal" href="../manual/cfg-statustargets.html#status-GerritStatusPush" title="GerritStatusPush"><code class="xref bb bb-status docutils literal"><span class="pre">GerritStatusPush</span></code></a> can be used
to send a message back to the committer.
See the linked documentation for details.</li>
<li>bb:sched:<cite>ChoiceStringParameter</cite> has a new method <code class="docutils literal"><span class="pre">getChoices</span></code> that can be used to generate
content dynamically for Force scheduler forms.</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>Features<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h3>
<ul class="simple">
<li>The fix for Twisted bug #5079 is now applied on the slave side, too.
This fixes a perspective broker memory leak in older versions of Twisted.
This fix was added on the master in Buildbot-0.8.4 (see <a class="reference external" href="http://trac.buildbot.net/ticket/1958" title="bug #1958">bug #1958</a>).</li>
<li>The <code class="docutils literal"><span class="pre">--nodaemon</span></code> option to <code class="docutils literal"><span class="pre">buildslave</span> <span class="pre">start</span></code> now correctly prevents the slave from forking before running.</li>
</ul>
</div>
<div class="section" id="id2">
<h3>Deprecations, Removals, and Non-Compatible Changes<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-none"><div class="highlight"><pre><span></span>git log v0.8.7..v0.8.8
</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/relnotes/" title="master/docs/relnotes/"><code class="docutils literal"><span class="pre">master/docs/relnotes/</span></code></a> directory of the source tree.
Newer versions are also available here:</p>
<div class="toctree-wrapper compound">
<ul>
<li class="toctree-l1"><a class="reference internal" href="0.8.7.html">Release Notes for Buildbot v0.8.7</a></li>
<li class="toctree-l1"><a class="reference internal" href="0.8.6.html">Release Notes for Buildbot v0.8.6p1</a></li>
</ul>
</div>
</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.12</a><ul class="current">
<li class="toctree-l2 current"><a class="reference internal" href="0.8.10.html">Release Notes for Buildbot 0.8.10</a><ul class="current">
<li class="toctree-l3 current"><a class="reference internal" href="0.8.9.html">Release Notes for Buildbot 0.8.9</a><ul class="current">
<li class="toctree-l4 current"><a class="current reference internal" href="#">Release Notes for Buildbot v0.8.8</a><ul>
<li class="toctree-l5"><a class="reference internal" href="0.8.7.html">Release Notes for Buildbot v0.8.7</a></li>
<li class="toctree-l5"><a class="reference internal" href="0.8.6.html">Release Notes for Buildbot v0.8.6p1</a></li>
</ul>
</li>
<li class="toctree-l4"><a class="reference internal" href="0.8.7.html">Release Notes for Buildbot v0.8.7</a></li>
<li class="toctree-l4"><a class="reference internal" href="0.8.6.html">Release Notes for Buildbot v0.8.6p1</a></li>
</ul>
</li>
<li class="toctree-l3 current"><a class="current reference internal" href="#">Release Notes for Buildbot v0.8.8</a><ul>
<li class="toctree-l4"><a class="reference internal" href="0.8.7.html">Release Notes for Buildbot v0.8.7</a></li>
<li class="toctree-l4"><a class="reference internal" href="0.8.6.html">Release Notes for Buildbot v0.8.6p1</a></li>
</ul>
</li>
<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"><a class="reference internal" href="0.8.6.html">Release Notes for Buildbot v0.8.6p1</a></li>
</ul>
</li>
<li class="toctree-l2 current"><a class="reference internal" href="0.8.9.html">Release Notes for Buildbot 0.8.9</a><ul class="current">
<li class="toctree-l3 current"><a class="current reference internal" href="#">Release Notes for Buildbot v0.8.8</a><ul>
<li class="toctree-l4"><a class="reference internal" href="0.8.7.html">Release Notes for Buildbot v0.8.7</a></li>
<li class="toctree-l4"><a class="reference internal" href="0.8.6.html">Release Notes for Buildbot v0.8.6p1</a></li>
</ul>
</li>
<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"><a class="reference internal" href="0.8.6.html">Release Notes for Buildbot v0.8.6p1</a></li>
</ul>
</li>
<li class="toctree-l2 current"><a class="current reference internal" href="#">Release Notes for Buildbot v0.8.8</a><ul>
<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"><a class="reference internal" href="0.8.6.html">Release Notes for Buildbot v0.8.6p1</a></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"><a class="reference internal" href="0.8.6.html">Release Notes for Buildbot v0.8.6p1</a></li>
</ul>
</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="0.8.9.html" title="Release Notes for Buildbot 0.8.9"
>previous</a> |
<a href="0.8.7.html" title="Release Notes for Buildbot v0.8.7"
>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/relnotes/0.8.8.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>
