6502/llvm-6502
1
0
Fork 0
mirror of https://github.com/c64scene-ar/llvm-6502.git synced 2025-06-13 04:38:24 +00:00
Code Issues Projects Releases Wiki Activity

Cleaned text, fixed HTML.

Browse Source 
git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@143607 91177308-0d34-0410-b5e6-96231b3b80d8
This commit is contained in:
Galina Kistanova
2011-11-03 05:57:26 +00:00
parent 463fe24f1d
commit b65bc5a3dc
1 changed files with 79 additions and 63 deletions
Download Patch File Download Diff File Expand all files Collapse all files

142
docs/HowToAddABuilder.html
View File

@ -3,7 +3,9 @@
<html> <html>
<head> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>How To Add Your Build Configuration To LLVM Buildbot Infrastructure</title> <title>
How To Add Your Build Configuration To LLVM Buildbot Infrastructure
</title>
<link rel="stylesheet" href="llvm.css" type="text/css"> <link rel="stylesheet" href="llvm.css" type="text/css">
</head> </head>
<body> <body>
@ -11,11 +13,10 @@
<h1>How To Add Your Build Configuration To LLVM Buildbot Infrastructure</h1> <h1>How To Add Your Build Configuration To LLVM Buildbot Infrastructure</h1>
<ol> <ol>
<li><a href="#introduction">Introduction</a></li> <li><a href="#introduction">Introduction</a></li>
<li><a href="#process">Steps To Add Builder To LLVM Buildbot</a></li> <li><a href="#steps">Steps To Add Builder To LLVM Buildbot</a></li>
</ol> </ol>
<div class="doc_author"> <div class="doc_author">
<p>Written by <a href="mailto:gkistanova@gmail.com">Galina Kistanova</a> <p>Written by <a href="mailto:gkistanova@gmail.com">Galina Kistanova</a></p>
</p>
</div> </div>
<!-- *********************************************************************** --> <!-- *********************************************************************** -->
@ -24,89 +25,104 @@
<div> <div>
<p>This document contains information about adding a build configuration and <p>This document contains information about adding a build configuration and
buildslave to private slave builder to LLVM Buildbot Infrastructure buildslave to private slave builder to LLVM Buildbot Infrastructure
<a href="http://lab.llvm.org:8011">http://lab.llvm.org:8011</a> <a href="http://lab.llvm.org:8011">http://lab.llvm.org:8011</a></p>
</div> </div>
<!-- *********************************************************************** --> <!-- *********************************************************************** -->
<h2><a name="process">Steps To Add Builder To LLVM Buildbot</a></h2> <h2><a name="steps">Steps To Add Builder To LLVM Buildbot</a></h2>
<!-- *********************************************************************** --> <!-- *********************************************************************** -->
<div> <div>
<p>Volunteers can provide their build machines to work as build slaves to <p>Volunteers can provide their build machines to work as build slaves to
public LLVM Buildbot. Below described recommended steps to implement this public LLVM Buildbot.</p>
task.</p>
<p>The steps are roughly as follows:</p> <p>Here are the steps you can follow to do so:</p>
<ol> <ol>
<li><p>Check the existing build configurations to make sure the one you are <li><p>Check the existing build configurations to make sure the one you are
interested in is not covered yet or gets built on your computer much interested in is not covered yet or gets built on your computer much
faster than on the existing one. We prefer faster builds so developers faster than on the existing one. We prefer faster builds so developers
will get feedback sooner after changes get committed.</p></li> will get feedback sooner after changes get committed.</p></li>
<li><p>The computer you will be registering with the LLVM buildbot <li><p>The computer you will be registering with the LLVM buildbot
infrastructure should have all dependencies installed and you can infrastructure should have all dependencies installed and you can
actually build your configuration successfully. You can build multiple actually build your configuration successfully. Please check what degree
configurations on one computer.</p></li> of parallelism (-j param) would give the fastest build.
You can build multiple configurations on one computer.</p></li>
<li><p>Install buildslave (currently we are using buildbot version 0.8.5). <li><p>Install buildslave (currently we are using buildbot version 0.8.5).
Depending on the platform, buildslave could be available to download and Depending on the platform, buildslave could be available to download and
install with your packet manager, or you can download it directly from install with your packet manager, or you can download it directly from
<a href="http://trac.buildbot.net">http://trac.buildbot.net</a> and <a href="http://trac.buildbot.net">http://trac.buildbot.net</a> and
install it manually.</p></li> install it manually.</p></li>
<li><p>Create a designated user account your buildslave will be running <li><p>Create a designated user account, your buildslave will be running
under.</p></li> under, and set appropriate permissions.</p></li>
<li><p>Choose the buildslave root directory (all builds will be placed under <li><p>Choose the buildslave root directory (all builds will be placed under
it), buildslave access name and password the build master will be using it), buildslave access name and password the build master will be using
to authenticate your build slave.</p></li> to authenticate your buildslave.</p></li>
<li><p>Then create a build slave in context of that buildslave account. <li><p>Create a buildslave in context of that buildslave account.
Point it to the lab.llvm.org port 9990<br /> Point it to the <b>lab.llvm.org</b> port <b>9990</b> (see
(see <tt>http://buildbot.net/buildbot/docs/current/full.html#creating-a-slave</tt> <a href="http://buildbot.net/buildbot/docs/current/full.html#creating-a-slave">
for more details) by running the following command: Buildbot documentation, Creating a slave</a>
<div class="doc_code"> for more details) by running the following command:</p>
<pre>
$ buildslave create-slave <i>buildslave-root-directory</i> lab.llvm.org: 9990 \
<i>buildslave-access-name buildslave-access-password</i>
</pre></div></p></li>
<li><p>Fill the build slave description and admin name/e-mail. <div class="doc_code">
Here is an example of the build slave description: <pre>
<div class="doc_code"> $ buildslave create-slave <i>buildslave-root-directory</i> \
<pre> lab.llvm.org:9990 \
Windows 7 x64 <i>buildslave-access-name buildslave-access-password</i>
Core i7 (2.66GHz), 16GB of RAM </pre>
</div></li>
g++.exe (TDM-1 mingw32) 4.4.0 <li><p>Fill the buildslave description and admin name/e-mail.
GNU Binutils 2.19.1 Here is an example of the buildslave description:</p>
cmake version 2.8.4
Microsoft(R) 32-bit C/C++ Optimizing Compiler Version 16.00.40219.01 for 80x86
</pre></div></p></li>
<li><p>Make sure you can actually start the buildslave successfully. Then set <div class="doc_code">
up your build slave to start automatically at the start up time. <pre>
See buildbot manual for help. You may want to restart your computer to see if it works.</p></li> Windows 7 x64
Core i7 (2.66GHz), 16GB of RAM
<li><p>Send a patch which adds your build slave and builder to zorg.<br /> g++.exe (TDM-1 mingw32) 4.4.0
* slaves are added to<br /> GNU Binutils 2.19.1
<tt>http://llvm.org/svn/llvm-project/zorg/trunk/buildbot/osuosl/master/config/slaves.py</tt><br /> cmake version 2.8.4
* builders are added to<br /> Microsoft(R) 32-bit C/C++ Optimizing Compiler Version 16.00.40219.01 for 80x86
<tt>http://llvm.org/svn/llvm-project/zorg/trunk/buildbot/osuosl/master/config/builders.py</tt></p></li> </pre>
</div></li>
<li><p>Then send the buildslave access name and password directly to <li><p>Make sure you can actually start the buildslave successfully. Then set
<a href="mailto:gkistanova@gmail.com">Galina Kistanova</a> up your buildslave to start automatically at the start up time.
See the buildbot documentation for help.
You may want to restart your computer to see if it works.</p></li>
<li><p>Check the status of your buildslave on <li><p>Send a patch which adds your build slave and your builder to zorg.</p>
http://lab.llvm.org:8011/waterfall to make sure it is connected, and <ul>
http://lab.llvm.org:8011/buildslaves/&lt;your buildslave name&gt; to see <li>slaves are added to
if the information is correct.</p></li> <tt>buildbot/osuosl/master/config/slaves.py</tt></li>
<li>builders are added to
<tt>buildbot/osuosl/master/config/builders.py</tt></li>
</ul></li>
<li><p>Wait for the first build to succeed and see if it could go faster with <li><p>Send the buildslave access name and the access password directly
higher degree of parallelism (-j param).</p></li> to <a href="mailto:gkistanova@gmail.com">Galina Kistanova</a>, and wait
till she will let you know that your changes are applied and buildmaster
is reconfigured.</p>
<li><p>Check the status of your buildslave on the
<a href="http://lab.llvm.org:8011/waterfall">Waterfall Display</a>
to make sure it is connected, and
<a href="http://lab.llvm.org:8011/buildslaves/your-buildslave-name">
http://lab.llvm.org:8011/buildslaves/&lt;your-buildslave-name&gt;</a>
to see if administrator contact and slave information are correct.</p>
</li>
<li><p>Wait for the first build to succeed and enjoy.</p></li>
</ol> </ol>
</div> </div>