diff --git a/docs/HowToAddABuilder.html b/docs/HowToAddABuilder.html index 3913f358afe9..0de2dacebe2b 100644 --- a/docs/HowToAddABuilder.html +++ b/docs/HowToAddABuilder.html @@ -3,7 +3,9 @@ - How To Add Your Build Configuration To LLVM Buildbot Infrastructure + + How To Add Your Build Configuration To LLVM Buildbot Infrastructure + @@ -11,11 +13,10 @@

How To Add Your Build Configuration To LLVM Buildbot Infrastructure

  1. Introduction
  2. -
  3. Steps To Add Builder To LLVM Buildbot
  4. +
  5. Steps To Add Builder To LLVM Buildbot
-

Written by Galina Kistanova -

+

Written by Galina Kistanova

@@ -24,89 +25,104 @@

Introduction

-

This document contains information about adding a build configuration and - buildslave to private slave builder to LLVM Buildbot Infrastructure - http://lab.llvm.org:8011 +

This document contains information about adding a build configuration and + buildslave to private slave builder to LLVM Buildbot Infrastructure + http://lab.llvm.org:8011

+
-

Steps To Add Builder To LLVM Buildbot

+

Steps To Add Builder To LLVM Buildbot

+

Volunteers can provide their build machines to work as build slaves to - public LLVM Buildbot. Below described recommended steps to implement this - task.

+ public LLVM Buildbot.

-

The steps are roughly as follows:

+

Here are the steps you can follow to do so:

    -
  1. 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 +

  2. 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.

  3. -
  4. 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.

  5. +
  6. 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.

  7. -
  8. 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 - http://trac.buildbot.net and +

  9. 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 + http://trac.buildbot.net and install it manually.

  10. -
  11. Create a designated user account your buildslave will be running - under.

  12. - -
  13. 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.

  14. - -
  15. Then create a build slave in context of that buildslave account. - Point it to the lab.llvm.org port 9990
    - (see http://buildbot.net/buildbot/docs/current/full.html#creating-a-slave - for more details) by running the following command: -

    -
    -      $ buildslave create-slave buildslave-root-directory lab.llvm.org: 9990 \
    -      buildslave-access-name buildslave-access-password
    -      

  16. - -
  17. Fill the build slave description and admin name/e-mail. - Here is an example of the build slave description: -

    -
    -           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
    -      

  18. - -
  19. 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.

  20. - -
  21. Send a patch which adds your build slave and builder to zorg.
    - * slaves are added to
    -http://llvm.org/svn/llvm-project/zorg/trunk/buildbot/osuosl/master/config/slaves.py
    - * builders are added to
    -http://llvm.org/svn/llvm-project/zorg/trunk/buildbot/osuosl/master/config/builders.py

  22. - -
  23. Then send the buildslave access name and password directly to - Galina Kistanova - -

  24. 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.

  25. - -
  26. Wait for the first build to succeed and see if it could go faster with - higher degree of parallelism (-j param).

  27. +
  28. Create a designated user account, your buildslave will be running + under, and set appropriate permissions.

  29. + +
  30. 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.

  31. + +
  32. Create a buildslave in context of that buildslave account. + Point it to the lab.llvm.org port 9990 (see + + Buildbot documentation, Creating a slave + for more details) by running the following command:

    + +
    +
    +$ buildslave create-slave buildslave-root-directory \
    +             lab.llvm.org:9990 \
    +             buildslave-access-name buildslave-access-password
    +
    +
  33. + +
  34. Fill the buildslave description and admin name/e-mail. + Here is an example of the buildslave description:

    + +
    +
    +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
    +
    +
  35. + +
  36. 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.

  37. + +
  38. Send a patch which adds your build slave and your builder to zorg.

    +
      +
    • slaves are added to + buildbot/osuosl/master/config/slaves.py
    • +
    • builders are added to + buildbot/osuosl/master/config/builders.py
    • +
  39. + +
  40. Send the buildslave access name and the access password directly + to Galina Kistanova, and wait + till she will let you know that your changes are applied and buildmaster + is reconfigured.

    + +
  41. Check the status of your buildslave on the + Waterfall Display + to make sure it is connected, and + + http://lab.llvm.org:8011/buildslaves/<your-buildslave-name> + to see if administrator contact and slave information are correct.

    +
  42. + +
  43. Wait for the first build to succeed and enjoy.