<html lang="en">
<head>
<title>Buildslaves - BuildBot Manual - 0.8.4p1</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="BuildBot Manual - 0.8.4p1">
<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Configuration.html#Configuration" title="Configuration">
<link rel="prev" href="Schedulers.html#Schedulers" title="Schedulers">
<link rel="next" href="Builders.html#Builders" title="Builders">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
This is the BuildBot manual for Buildbot version 0.8.4p1.
Copyright (C) 2005, 2006, 2009, 2010 Brian Warner
Copying and distribution of this file, with or without
modification, are permitted in any medium without royalty
provided the copyright notice and this notice are preserved.-->
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
pre.display { font-family:inherit }
pre.format { font-family:inherit }
pre.smalldisplay { font-family:inherit; font-size:smaller }
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
span.sc { font-variant:small-caps }
span.roman { font-family:serif; font-weight:normal; }
span.sansserif { font-family:sans-serif; font-weight:normal; }
--></style>
</head>
<body>
<div class="node">
<a name="Buildslaves"></a>
<p>
Next: <a rel="next" accesskey="n" href="Builders.html#Builders">Builders</a>,
Previous: <a rel="previous" accesskey="p" href="Schedulers.html#Schedulers">Schedulers</a>,
Up: <a rel="up" accesskey="u" href="Configuration.html#Configuration">Configuration</a>
<hr>
</div>
<h3 class="section">4.9 Buildslaves</h3>
<p><a name="index-c_005b_0027slaves_0027_005d-67"></a>
The <code>c['slaves']</code> key is a list of known buildslaves. In the common case,
each buildslave is defined by an instance of the BuildSlave class. It
represents a standard, manually started machine that will try to connect to
the buildbot master as a slave. Contrast these with the "on-demand" latent
buildslaves, such as the Amazon Web Service Elastic Compute Cloud latent
buildslave discussed below.
<p>The BuildSlave class is instantiated with two values: (slavename,
slavepassword). These are the same two values that need to be provided to the
buildslave administrator when they create the buildslave.
<p>The slavenames must be unique, of course. The password exists to
prevent evildoers from interfering with the buildbot by inserting
their own (broken) buildslaves into the system and thus displacing the
real ones.
<p>Buildslaves with an unrecognized slavename or a non-matching password
will be rejected when they attempt to connect, and a message
describing the problem will be put in the log file (see <a href="Logfiles.html#Logfiles">Logfiles</a>).
<pre class="example"> from buildbot.buildslave import BuildSlave
c['slaves'] = [BuildSlave('bot-solaris', 'solarispasswd'),
BuildSlave('bot-bsd', 'bsdpasswd'),
]
</pre>
<p><a name="index-Properties-68"></a><code>BuildSlave</code> objects can also be created with an optional
<code>properties</code> argument, a dictionary specifying properties that
will be available to any builds performed on this slave. For example:
<pre class="example"> from buildbot.buildslave import BuildSlave
c['slaves'] = [BuildSlave('bot-solaris', 'solarispasswd',
properties={'os':'solaris'}),
]
</pre>
<p>The <code>BuildSlave</code> constructor can also take an optional
<code>max_builds</code> parameter to limit the number of builds that it
will execute simultaneously:
<pre class="example"> from buildbot.buildslave import BuildSlave
c['slaves'] = [BuildSlave("bot-linux", "linuxpassword", max_builds=2)]
</pre>
<ul class="menu">
<li><a accesskey="1" href="Master_002dslave-TCP-Keepalive.html#Master_002dslave-TCP-Keepalive">Master-slave TCP Keepalive</a>
<li><a accesskey="2" href="When-Buildslaves-Go-Missing.html#When-Buildslaves-Go-Missing">When Buildslaves Go Missing</a>
<li><a accesskey="3" href="Latent-Buildslaves.html#Latent-Buildslaves">Latent Buildslaves</a>
</ul>
</body></html>
