How To Release LLVM To The Public

This document contains information about adding private slave builder to LLVM Buildbot Infrastructure: http://lab.llvm.org:8011

Volunters can provade there build machines to work as slave builders to public LLVM Buildbot. Below desrcibed recommended steps to implement this task.

The steps are roughly as follows:

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 existing one. We prefer faster builds so developers will get feedback sooner after changes get committed.

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

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

4. Create a designated user account your buildslave will be running under.

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

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

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

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

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

10. Then send the buildslave access name and password directly to Galina Kistanova

11. Finally, the end!