From ea0a8c9ca58c47f0f9ea49a30c16643e8a0b32bd Mon Sep 17 00:00:00 2001 From: Galina Kistanova Date: Mon, 31 Oct 2011 21:13:06 +0000 Subject: Added instruction how to add a builder to docs. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@143365 91177308-0d34-0410-b5e6-96231b3b80d8 --- docs/HowToAddABuilder.html | 118 +++++++++++++++++++++++++++++++++++++++++++++ docs/index.html | 4 ++ 2 files changed, 122 insertions(+) create mode 100644 docs/HowToAddABuilder.html (limited to 'docs') diff --git a/docs/HowToAddABuilder.html b/docs/HowToAddABuilder.html new file mode 100644 index 0000000000..62cb85b11f --- /dev/null +++ b/docs/HowToAddABuilder.html @@ -0,0 +1,118 @@ + + + + + How To Add Your Build Configuration To LLVM Buildbot Infrastructure + + + + +

How To Release LLVM To The Public

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

Written by Galina Kistanova +

+
+ + +

Introduction

+ + +
+ +

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

+ + +

Steps To Add Builder To LLVM Buildbot

+ +
+ +

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

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

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

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

    5. + +

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

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

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

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

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

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

  11. Finally, the end!

    12. +
+ +
+ + +
+
+ Valid CSS + Valid HTML 4.01 + The LLVM Compiler Infrastructure +
+ Last modified: $Date: 2011-10-31 12:50:0 -0700 (Mon, 31 Oct 2011) $ +
+ + diff --git a/docs/index.html b/docs/index.html index f57231ac2b..89ed61d523 100644 --- a/docs/index.html +++ b/docs/index.html @@ -129,6 +129,10 @@ channel. We often are on irc.oftc.net in the #llvm channel. If you are using the mozilla browser, and have chatzilla installed, you can join #llvm on irc.oftc.net directly. +
  • How To Add Your Build Configuration +To LLVM Buildbot Infrastructure - Instructions for adding new builder to +LLVM buildbot master.
    • + -- cgit v1.2.3