<!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.8 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.8', 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.8 documentation" href="../index.html" /> <link rel="up" title="Release Notes for Buildbot v0.8.8" 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.8 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 <a class="reference internal" href="../manual/cfg-changesources.html#mercurial-hook"><em>the Buildbot manual</em></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 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-python"><pre>git log buildbot-0.8.5..buildbot-0.8.6</pre> </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 v0.8.8</a><ul class="current"> <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.pocoo.org/">Sphinx</a> 1.1.3. </div> </div> <div class="clearer"></div> </div> </div> </body> </html>