<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head><meta http-equiv="content-type" content="text/html; charset=utf-8" />
<title>[151681] contrib/buildbot-test/README.md</title>
</head>
<body>

<style type="text/css"><!--
#msg dl.meta { border: 1px #006 solid; background: #369; padding: 6px; color: #fff; }
#msg dl.meta dt { float: left; width: 6em; font-weight: bold; }
#msg dt:after { content:':';}
#msg dl, #msg dt, #msg ul, #msg li, #header, #footer, #logmsg { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt;  }
#msg dl a { font-weight: bold}
#msg dl a:link    { color:#fc3; }
#msg dl a:active  { color:#ff0; }
#msg dl a:visited { color:#cc6; }
h3 { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; font-weight: bold; }
#msg pre { overflow: auto; background: #ffc; border: 1px #fa0 solid; padding: 6px; }
#logmsg { background: #ffc; border: 1px #fa0 solid; padding: 1em 1em 0 1em; }
#logmsg p, #logmsg pre, #logmsg blockquote { margin: 0 0 1em 0; }
#logmsg p, #logmsg li, #logmsg dt, #logmsg dd { line-height: 14pt; }
#logmsg h1, #logmsg h2, #logmsg h3, #logmsg h4, #logmsg h5, #logmsg h6 { margin: .5em 0; }
#logmsg h1:first-child, #logmsg h2:first-child, #logmsg h3:first-child, #logmsg h4:first-child, #logmsg h5:first-child, #logmsg h6:first-child { margin-top: 0; }
#logmsg ul, #logmsg ol { padding: 0; list-style-position: inside; margin: 0 0 0 1em; }
#logmsg ul { text-indent: -1em; padding-left: 1em; }#logmsg ol { text-indent: -1.5em; padding-left: 1.5em; }
#logmsg > ul, #logmsg > ol { margin: 0 0 1em 0; }
#logmsg pre { background: #eee; padding: 1em; }
#logmsg blockquote { border: 1px solid #fa0; border-left-width: 10px; padding: 1em 1em 0 1em; background: white;}
#logmsg dl { margin: 0; }
#logmsg dt { font-weight: bold; }
#logmsg dd { margin: 0; padding: 0 0 0.5em 0; }
#logmsg dd:before { content:'\00bb';}
#logmsg table { border-spacing: 0px; border-collapse: collapse; border-top: 4px solid #fa0; border-bottom: 1px solid #fa0; background: #fff; }
#logmsg table th { text-align: left; font-weight: normal; padding: 0.2em 0.5em; border-top: 1px dotted #fa0; }
#logmsg table td { text-align: right; border-top: 1px dotted #fa0; padding: 0.2em 0.5em; }
#logmsg table thead th { text-align: center; border-bottom: 1px solid #fa0; }
#logmsg table th.Corner { text-align: left; }
#logmsg hr { border: none 0; border-top: 2px dashed #fa0; height: 1px; }
#header, #footer { color: #fff; background: #636; border: 1px #300 solid; padding: 6px; }
#patch { width: 100%; }
#patch h4 {font-family: verdana,arial,helvetica,sans-serif;font-size:10pt;padding:8px;background:#369;color:#fff;margin:0;}
#patch .propset h4, #patch .binary h4 {margin:0;}
#patch pre {padding:0;line-height:1.2em;margin:0;}
#patch .diff {width:100%;background:#eee;padding: 0 0 10px 0;overflow:auto;}
#patch .propset .diff, #patch .binary .diff  {padding:10px 0;}
#patch span {display:block;padding:0 10px;}
#patch .modfile, #patch .addfile, #patch .delfile, #patch .propset, #patch .binary, #patch .copfile {border:1px solid #ccc;margin:10px 0;}
#patch ins {background:#dfd;text-decoration:none;display:block;padding:0 10px;}
#patch del {background:#fdd;text-decoration:none;display:block;padding:0 10px;}
#patch .lines, .info {color:#888;background:#fff;}
--></style>
<div id="msg">
<dl class="meta">
<dt>Revision</dt> <dd><a href="https://trac.macports.org/changeset/151681">151681</a></dd>
<dt>Author</dt> <dd>larryv@macports.org</dd>
<dt>Date</dt> <dd>2016-08-19 18:09:53 -0700 (Fri, 19 Aug 2016)</dd>
</dl>

<h3>Log Message</h3>
<pre>buildbot: Hard-wrap lines in README</pre>

<h3>Modified Paths</h3>
<ul>
<li><a href="#contribbuildbottestREADMEmd">contrib/buildbot-test/README.md</a></li>
</ul>

</div>
<div id="patch">
<h3>Diff</h3>
<a id="contribbuildbottestREADMEmd"></a>
<div class="modfile"><h4>Modified: contrib/buildbot-test/README.md (151680 => 151681)</h4>
<pre class="diff"><span>
<span class="info">--- contrib/buildbot-test/README.md        2016-08-19 22:46:36 UTC (rev 151680)
+++ contrib/buildbot-test/README.md        2016-08-20 01:09:53 UTC (rev 151681)
</span><span class="lines">@@ -2,12 +2,17 @@
</span><span class="cx"> 
</span><span class="cx"> ## Setting up both buildbot master and slave for testing on localhost
</span><span class="cx"> 
</span><del>-These steps explain how to install buildbot locally for hacking on the infrastructure. This will run both the buildbot master and buildbot slave on localhost. Note that the buildbot slave will run in a non-default prefix, to avoid interfering with your installation in `/opt/local`.
</del><ins>+These steps explain how to install buildbot locally for hacking on the
+infrastructure. This will run both the buildbot master and buildbot
+slave on localhost. Note that the buildbot slave will run in
+a non-default prefix, to avoid interfering with your installation in
+`/opt/local`.
</ins><span class="cx"> 
</span><span class="cx"> For a production setup you would probably want the reverse:
</span><span class="cx"> 
</span><span class="cx">   * let the buildbot slave build ports in `/opt/local`
</span><del>-  * place the auxiliary installation for tools somewhere else, for example under `/opt/mports`
</del><ins>+  * place the auxiliary installation for tools somewhere else, for
+    example under `/opt/mports`
</ins><span class="cx"> 
</span><span class="cx"> The exact locations can be configured with `config.json.sample`.
</span><span class="cx"> 
</span><span class="lines">@@ -45,7 +50,9 @@
</span><span class="cx"> 
</span><span class="cx"> #### 5. Starting buildbot
</span><span class="cx"> 
</span><del>-To start buildbot, execute the `start` command. The OS X firewall will request you to allow access for Python. Then you can view the buildbot instance in your web browser. 
</del><ins>+To start buildbot, execute the `start` command. The OS X firewall will
+request you to allow access for Python. Then you can view the buildbot
+instance in your web browser.
</ins><span class="cx"> 
</span><span class="cx">     buildbot start /opt/mp-buildbot/master
</span><span class="cx">     open http://localhost:8010/
</span><span class="lines">@@ -53,7 +60,10 @@
</span><span class="cx"> 
</span><span class="cx"> #### 5. Testing changes
</span><span class="cx"> 
</span><del>-After making any changes to `master.cfg`, you can reload the configuration with the `reconfig` command. This is faster than doing a full `restart`. In a similar way, you can completely `stop` the buildbot.
</del><ins>+After making any changes to `master.cfg`, you can reload the
+configuration with the `reconfig` command. This is faster than doing
+a full `restart`. In a similar way, you can completely `stop` the
+buildbot.
</ins><span class="cx"> 
</span><span class="cx">     buildbot reconfig /opt/mp-buildbot/master
</span><span class="cx">  
</span><span class="lines">@@ -64,16 +74,21 @@
</span><span class="cx"> 
</span><span class="cx"> ### Setting up buildbot slave on localhost
</span><span class="cx"> 
</span><del>-This will use your copy of MacPorts in `/opt/local` for all tooling, but actual builds on the slave will be made in a separate prefix. Make sure this installation provides an up-to-date ports tree.
</del><ins>+This will use your copy of MacPorts in `/opt/local` for all tooling, but
+actual builds on the slave will be made in a separate prefix. Make sure
+this installation provides an up-to-date ports tree.
</ins><span class="cx"> 
</span><del>-You will need the subversion port in this prefix for tooling, as `/usr/bin/svn` will have problems validating the Subversion server certificate due to a well-known bug in Mac OS X &gt;= 10.7.
</del><ins>+You will need the subversion port in this prefix for tooling, as
+`/usr/bin/svn` will have problems validating the Subversion server
+certificate due to a well-known bug in Mac OS X &gt;= 10.7.
</ins><span class="cx"> 
</span><span class="cx">     sudo port install subversion
</span><span class="cx"> 
</span><span class="cx"> 
</span><span class="cx"> #### 1. Install MacPorts into a new prefix
</span><span class="cx"> 
</span><del>-You need to use a new prefix for this installation. These instructions will use `/opt/mp-buildbot/prefix`.
</del><ins>+You need to use a new prefix for this installation. These instructions
+will use `/opt/mp-buildbot/prefix`.
</ins><span class="cx"> 
</span><span class="cx"> You will have to install this from source following
</span><span class="cx"> 
</span><span class="lines">@@ -95,7 +110,8 @@
</span><span class="cx">     sudo chown -R $USER:buildbot /opt/mp-buildbot
</span><span class="cx">     sudo chmod -R 775 /opt/mp-buildbot
</span><span class="cx"> 
</span><del>-Create two buildslaves, one for base running as the buildbot user, one for ports running as root:
</del><ins>+Create two buildslaves, one for base running as the buildbot user, one
+for ports running as root:
</ins><span class="cx"> 
</span><span class="cx">     OSXVERS=$(sw_vers -productVersion | grep -oE '^[0-9]+\.[0-9]+')
</span><span class="cx">     ARCH=$(uname -m)
</span><span class="lines">@@ -117,7 +133,9 @@
</span><span class="cx"> 
</span><span class="cx"> #### 3. Add new builldbot slaves to buildbot master configuration
</span><span class="cx"> 
</span><del>-Add the buildslaves to your buildmaster's master.cfg using the password you provided when creating them. Then reload the buildbot master configuration.
</del><ins>+Add the buildslaves to your buildmaster's master.cfg using the password
+you provided when creating them. Then reload the buildbot master
+configuration.
</ins><span class="cx"> 
</span><span class="cx">     $EDITOR /opt/mp-buildbot/master/slaves.json
</span><span class="cx"> 
</span><span class="lines">@@ -137,7 +155,8 @@
</span><span class="cx"> 
</span><span class="cx"> #### 4. Start the two buildslaves
</span><span class="cx"> 
</span><del>-These commands start the new build slaves. They should connect to the master successfully and be visible in the webinterface.
</del><ins>+These commands start the new build slaves. They should connect to the
+master successfully and be visible in the webinterface.
</ins><span class="cx"> 
</span><span class="cx">     sudo -H -u buildbot buildslave start /opt/mp-buildbot/slave-base
</span><span class="cx">     sudo -H buildslave start /opt/mp-buildbot/slave-ports
</span><span class="lines">@@ -150,6 +169,8 @@
</span><span class="cx"> 
</span><span class="cx"> ## Setting up buildbot master and slaves for production
</span><span class="cx"> 
</span><del>-These instructions explain how to install buildbot in a production environment, in which master slaves run on different machines to produce MacPorts packages.
</del><ins>+These instructions explain how to install buildbot in a production
+environment, in which master slaves run on different machines to produce
+MacPorts packages.
</ins><span class="cx"> 
</span><span class="cx"> TODO
</span></span></pre>
</div>
</div>

</body>
</html>