How to add builder info. Need advice

Project Infrastructure LLVM Dev List Archives
#1

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:

#2

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

-Tanya

#3

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

#4

Takumi, Tanya,
Thanks for the suggestions!

The first draft is in the SVN ( llvm/trunk/docs/HowToAddABuilder.html).

I'd rather keep documentation with the documentation.
Plus I'd like us to be able to have multiple buildmasters later if we
want to (pre-release staging, for instance) without re-arranging the
stuff again.

By the way, it looks like web doesn't get auto-updated from the SVN.
Is it still broken?

Thanks,

Galina

#5

Takumi, Tanya,
Thanks for the suggestions!

The first draft is in the SVN ( llvm/trunk/docs/HowToAddABuilder.html).

I'd rather keep documentation with the documentation.
Plus I'd like us to be able to have multiple buildmasters later if we
want to (pre-release staging, for instance) without re-arranging the
stuff again.

By the way, it looks like web doesn't get auto-updated from the SVN.
Is it still broken?

Still broke. It will get updated once a night through the doxygen update, but not immediately when you check it in. I'm hoping to finally fix this this weekend. Its been annoying.

-Tanya