llvm dev - Oct 2011 - [LLVMdev] How to add builder info. Need advice

Hello everybody,

I want to put some kind of instruction on how to add new slave to llvm master.
I think it should be somewhere on llvm.org, but not sure on exact place.

Any comments/suggestions will be appreciated.

Thanks

Galina




If you want to add your build configuration to the LLVM buildbot infrastructure.

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 <gkistanova at gmail.com>.

Put it in the llvm/docs directory and link to the main documentation page? Maybe
add a link the main buildbot page too.

-Tanya

On Oct 26, 2011, at 5:54 PM, Galina Kistanova wrote:
> Hello everybody,
> 
> I want to put some kind of instruction on how to add new slave to llvm
master.
> I think it should be somewhere on llvm.org, but not sure on exact place.
> 
> Any comments/suggestions will be appreciated.
> 
> Thanks
> 
> Galina
> 
> 
> 
> 
> If you want to add your build configuration to the LLVM buildbot
infrastructure.
> 
> 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 <gkistanova at gmail.com>.
> _______________________________________________
> LLVM Developers mailing list
> LLVMdev at cs.uiuc.edu         http://llvm.cs.uiuc.edu
> http://lists.cs.uiuc.edu/mailman/listinfo/llvmdev

2011/10/27 Tanya Lattner <lattner at apple.com>:
> Put it in the llvm/docs directory and link to the main documentation page?
Maybe add a link the main buildbot page too.
I rather suggest;

  - Put instructions to zorg
  - Add a link to lab.llvm.org/instruction.html in llvm.org website.

llvm/docs might be suitable if llvm-specific issues in buildslaves.

...Takumi
>> 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
IIRC, I saw the description above in somewhere... :D