diff options
| author | Galina Kistanova <gkistanova@gmail.com> | 2011-11-03 05:57:26 +0000 |
|---|---|---|
| committer | Galina Kistanova <gkistanova@gmail.com> | 2011-11-03 05:57:26 +0000 |
| commit | b65bc5a3dcf1bbaf3ebb10a06cf479e957b238e0 (patch) | |
| tree | 37505edf1319fe5ecc2e3589d248acbe5a915e72 /docs/HowToAddABuilder.html | |
| parent | 463fe24f1dd5132607abb3548a2acb1849e9aa99 (diff) | |
| download | external_llvm-b65bc5a3dcf1bbaf3ebb10a06cf479e957b238e0.zip external_llvm-b65bc5a3dcf1bbaf3ebb10a06cf479e957b238e0.tar.gz external_llvm-b65bc5a3dcf1bbaf3ebb10a06cf479e957b238e0.tar.bz2 | |
Cleaned text, fixed HTML.
git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@143607 91177308-0d34-0410-b5e6-96231b3b80d8
Diffstat (limited to 'docs/HowToAddABuilder.html')
| -rw-r--r-- | docs/HowToAddABuilder.html | 160 |
1 files changed, 88 insertions, 72 deletions
diff --git a/docs/HowToAddABuilder.html b/docs/HowToAddABuilder.html index 3913f35..0de2dac 100644 --- a/docs/HowToAddABuilder.html +++ b/docs/HowToAddABuilder.html @@ -3,7 +3,9 @@ <html> <head> <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"> </head> <body> @@ -11,11 +13,10 @@ <h1>How To Add Your Build Configuration To LLVM Buildbot Infrastructure</h1> <ol> <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> <div class="doc_author"> - <p>Written by <a href="mailto:gkistanova@gmail.com">Galina Kistanova</a> - </p> + <p>Written by <a href="mailto:gkistanova@gmail.com">Galina Kistanova</a></p> </div> <!-- *********************************************************************** --> @@ -24,89 +25,104 @@ <div> -<p>This document contains information about adding a build configuration and - buildslave to private slave builder to LLVM Buildbot Infrastructure - <a href="http://lab.llvm.org:8011">http://lab.llvm.org:8011</a> +<p>This document contains information about adding a build configuration and + buildslave to private slave builder to LLVM Buildbot Infrastructure + <a href="http://lab.llvm.org:8011">http://lab.llvm.org:8011</a></p> + </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> <p>Volunteers can provide their build machines to work as build slaves to - public LLVM Buildbot. Below described recommended steps to implement this - task.</p> + public LLVM Buildbot.</p> -<p>The steps are roughly as follows:</p> +<p>Here are the steps you can follow to do so:</p> <ol> - <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 - faster than on the existing one. We prefer faster builds so developers + <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 + faster than on the existing one. We prefer faster builds so developers will get feedback sooner after changes get committed.</p></li> - <li><p>The computer you will be registering with the LLVM buildbot - infrastructure should have all dependencies installed and you can - actually build your configuration successfully. You can build multiple - configurations on one computer.</p></li> + <li><p>The computer you will be registering with the LLVM buildbot + infrastructure should have all dependencies installed and you can + actually build your configuration successfully. Please check what degree + 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). - Depending on the platform, buildslave could be available to download and - install with your packet manager, or you can download it directly from - <a href="http://trac.buildbot.net">http://trac.buildbot.net</a> and + <li><p>Install buildslave (currently we are using buildbot version 0.8.5). + Depending on the platform, buildslave could be available to download and + install with your packet manager, or you can download it directly from + <a href="http://trac.buildbot.net">http://trac.buildbot.net</a> and install it manually.</p></li> - <li><p>Create a designated user account your buildslave will be running - under.</p></li> - - <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 - to authenticate your build slave.</p></li> - - <li><p>Then create a build slave in context of that buildslave account. - Point it to the lab.llvm.org port 9990<br /> - (see <tt>http://buildbot.net/buildbot/docs/current/full.html#creating-a-slave</tt> - for more details) by running the following command: - <div class="doc_code"> - <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. - Here is an example of the build slave description: - <div class="doc_code"> - <pre> - Windows 7 x64 - Core i7 (2.66GHz), 16GB of RAM - - g++.exe (TDM-1 mingw32) 4.4.0 - GNU Binutils 2.19.1 - 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 - up your build slave to start automatically at the start up time. - See buildbot manual for help. You may want to restart your computer to see if it works.</p></li> - - <li><p>Send a patch which adds your build slave and builder to zorg.<br /> - * slaves are added to<br /> -<tt>http://llvm.org/svn/llvm-project/zorg/trunk/buildbot/osuosl/master/config/slaves.py</tt><br /> - * builders are added to<br /> -<tt>http://llvm.org/svn/llvm-project/zorg/trunk/buildbot/osuosl/master/config/builders.py</tt></p></li> - - <li><p>Then send the buildslave access name and password directly to - <a href="mailto:gkistanova@gmail.com">Galina Kistanova</a> - - <li><p>Check the status of your buildslave on - http://lab.llvm.org:8011/waterfall to make sure it is connected, and - http://lab.llvm.org:8011/buildslaves/<your buildslave name> to see - if the information is correct.</p></li> - - <li><p>Wait for the first build to succeed and see if it could go faster with - higher degree of parallelism (-j param).</p></li> + <li><p>Create a designated user account, your buildslave will be running + under, and set appropriate permissions.</p></li> + + <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 + to authenticate your buildslave.</p></li> + + <li><p>Create a buildslave in context of that buildslave account. + Point it to the <b>lab.llvm.org</b> port <b>9990</b> (see + <a href="http://buildbot.net/buildbot/docs/current/full.html#creating-a-slave"> + Buildbot documentation, Creating a slave</a> + for more details) by running the following command:</p> + +<div class="doc_code"> +<pre> +$ buildslave create-slave <i>buildslave-root-directory</i> \ + lab.llvm.org:9990 \ + <i>buildslave-access-name buildslave-access-password</i> +</pre> +</div></li> + + <li><p>Fill the buildslave description and admin name/e-mail. + Here is an example of the buildslave description:</p> + +<div class="doc_code"> +<pre> +Windows 7 x64 +Core i7 (2.66GHz), 16GB of RAM + +g++.exe (TDM-1 mingw32) 4.4.0 +GNU Binutils 2.19.1 +cmake version 2.8.4 +Microsoft(R) 32-bit C/C++ Optimizing Compiler Version 16.00.40219.01 for 80x86 +</pre> +</div></li> + + <li><p>Make sure you can actually start the buildslave successfully. Then set + 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>Send a patch which adds your build slave and your builder to zorg.</p> + <ul> + <li>slaves are added to + <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>Send the buildslave access name and the access password directly + 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/<your-buildslave-name></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> </div> |