<!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>First Buildbot run with Docker — 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 Tutorial" href="index.html" />
<link rel="next" title="A Quick Tour" href="tour.html" />
<link rel="prev" title="First Run" href="firstrun.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="firstrun.html" title="First Run"
accesskey="P">previous</a> |
<a href="tour.html" title="A Quick Tour"
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="first-buildbot-run-with-docker">
<span id="first-run-docker-label"></span><h1>First Buildbot run with Docker<a class="headerlink" href="#first-buildbot-run-with-docker" title="Permalink to this headline">¶</a></h1>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">Docker can be tricky to get working correctly if you haven't used it before.
If you're having trouble, first determine whether it is a Buildbot issue or a Docker issue by running docker run ubuntu:12.04 apt-get update.
If that fails, look for help with your Docker install.
On the other hand, if that succeeds, then you may have better luck getting help from members of the Buildbot community.</p>
</div>
<div class="admonition warning">
<p class="first admonition-title">Warning</p>
<p class="last">The instruction in this document are based on an <em>old</em> Dockerfile, not complying with the state-of-the-art best practices (all components in one container, access via ssh, ...).
While this approach provides an easy way to get first-hand experience with Buildbot, this is not the recommended way to deploy Buildbot in production.</p>
</div>
<p><a class="reference external" href="https://www.docker.com">Docker</a> is a tool that makes building and deploying custom environments a breeze.
It uses lightweight linux containers (LXC) and performs quickly, making it a great instrument for the testing community.
The next section includes a Docker pre-flight check.
If it takes more that 3 minutes to get the 'Success' message for you, try the Buildbot pip-based <a class="reference internal" href="firstrun.html#getting-code-label"><span class="std std-ref">first run</span></a> instead.</p>
<div class="section" id="current-docker-dependencies">
<h2>Current Docker dependencies<a class="headerlink" href="#current-docker-dependencies" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Linux system, with at least kernel 3.8 and AUFS support.
For example, Standard Ubuntu, Debian and Arch systems.</li>
<li>Packages: lxc, iptables, ca-certificates, and bzip2 packages.</li>
<li>Local clock on time or slightly in the future for proper SSL communication.</li>
</ul>
</div>
<div class="section" id="installation">
<h2>Installation<a class="headerlink" href="#installation" title="Permalink to this headline">¶</a></h2>
<ul>
<li><p class="first">Use the <a class="reference external" href="https://docs.docker.com/installation/">Docker installation instructions</a> for your operating system.</p>
</li>
<li><p class="first">Test docker is happy in your environment:</p>
<div class="highlight-bash"><div class="highlight"><pre><span></span>sudo docker run -i busybox /bin/echo Success
</pre></div>
</div>
</li>
</ul>
</div>
<div class="section" id="building-and-running-buildbot">
<h2>Building and running Buildbot<a class="headerlink" href="#building-and-running-buildbot" title="Permalink to this headline">¶</a></h2>
<div class="highlight-bash"><div class="highlight"><pre><span></span><span class="c1"># Download Buildbot Dockerfile.</span>
wget https://raw.github.com/buildbot/buildbot/master/master/contrib/Dockerfile
<span class="c1"># Build the Buildbot container (it will take a few minutes to download packages)</span>
docker build -t buildbot - < Dockerfile
<span class="c1"># Run buildbot</span>
<span class="nv">CONTAINER_ID</span><span class="o">=</span><span class="k">$(</span>docker run -d -p 8010:8010 -p <span class="m">22</span> buildbot<span class="k">)</span>
</pre></div>
</div>
<p>You should now be able to go to <a class="reference external" href="http://localhost:8010">http://localhost:8010</a> and see a web page similar to:</p>
<img alt="index page" src="../_images/index.png" />
<p>Click on the <a class="reference external" href="http://localhost:8010/waterfall">Waterfall Display link</a> and you get this:</p>
<img alt="empty waterfall." src="../_images/waterfall-empty.png" />
</div>
<div class="section" id="playing-with-your-buildbot-container">
<h2>Playing with your Buildbot container<a class="headerlink" href="#playing-with-your-buildbot-container" title="Permalink to this headline">¶</a></h2>
<p>If you've come this far, you have a Buildbot environment that you can freely experiment with.
You can access your container using ssh, the password is <code class="docutils literal"><span class="pre">admin</span></code>:</p>
<div class="highlight-bash"><div class="highlight"><pre><span></span>ssh -p <span class="k">$(</span>docker port <span class="nv">$CONTAINER_ID</span> <span class="m">22</span> <span class="p">|</span> cut -d: -f 2<span class="k">)</span> admin@localhost
</pre></div>
</div>
<p>You've got a taste now, but you're probably curious for more.
Let's step it up a little in the second tutorial by changing the configuration and doing an actual build.
Continue on to <a class="reference internal" href="tour.html#quick-tour-label"><span class="std std-ref">A Quick Tour</span></a>.</p>
</div>
</div>
</div>
</div>
</div>
</div>
<div class="sidebar">
<h3>Table Of Contents</h3>
<ul class="current">
<li class="toctree-l1 current"><a class="reference internal" href="index.html">Buildbot Tutorial</a><ul class="current">
<li class="toctree-l2"><a class="reference internal" href="firstrun.html">First Run</a></li>
<li class="toctree-l2 current"><a class="current reference internal" href="#">First Buildbot run with Docker</a><ul class="simple">
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="tour.html">A Quick Tour</a></li>
<li class="toctree-l2"><a class="reference internal" href="further.html">Further Reading</a></li>
</ul>
</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"><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="firstrun.html" title="First Run"
>previous</a> |
<a href="tour.html" title="A Quick Tour"
>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/tutorial/docker.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>
