Difference between revisions of "How to create new OSGeo BuildBot instance"

From OSGeo
Jump to navigation Jump to search
(First draft of this HOWTO)
(Overall reformatting)
Line 11: Line 11:
 
= Create BuildBot instance step-by-step =
 
= Create BuildBot instance step-by-step =
  
 +
== Assign new id ==
  
0. Assign new instance id: 0 - 99
+
New instance id: 0 - 99
  
1. Log into the buildbot@xblade
+
== Login on the server ==
  
2. Go do OSGEOBUILDHOME
+
ssh buildbot@[[BuildBot Configuration#Server|xblade14-2]]
  
3. Creating new BuildBot instance directory for project
+
== Go to OSGEOBUILDHOME ==
  
mkdir <projectname>
+
[buildbot@xblade14-2 buildbot]$ cd $OSGEOBUILDHOME
  
lowercase
+
== Creating directory for project ==
  
4.  Create directory for buildmaster:
+
New BuildBot instance directory for project, lowercase name:
  
mkdir buildmaster
+
$ mkdir <projectname>
  
5.  Create directory for buildslave:
+
== Create directory for buildmaster ==
  
mkdir buildslave
+
$ mkdir buildmaster
  
6. Run buildbot to create buildmaster
+
== Create directory for buildslave ==
  
buildbot create-master ${OSGEOBUILDHOME}/<projectname>/buildmaster
+
$ mkdir buildslave
  
7. Run buildbot to create buildslave
+
== Create buildmaster ==
  
buildbot create-slave ${OSGEOBUILDHOME}/<projectname>/buildslave MASTERHOST:PORT SLAVENAME PASSWORD
+
Run buildbot to create new buildmaster:
 +
 
 +
$ buildbot create-master ${OSGEOBUILDHOME}/<projectname>/buildmaster
 +
 
 +
== Create buildslave ==
 +
 
 +
$ buildbot create-slave ${OSGEOBUILDHOME}/<projectname>/buildslave MASTERHOST:PORT SLAVENAME PASSWORD
  
 
PORT: 15XX where XX is subsequent number of BuildBot instance (between 0-99)
 
PORT: 15XX where XX is subsequent number of BuildBot instance (between 0-99)
Line 44: Line 51:
 
PASSWORD: <new password>
 
PASSWORD: <new password>
  
8. Copy README and edit it.
+
== Configure BuildBot instance ==
 +
 
 +
Edit master.cfg
 +
 
 +
== Run ==
  
9. Edit master.cfg (!!!!!)
+
* Start
  
10. Try to run:
+
  $OSGEOBUILDHOME/buildbot_start.sh <projectname>
  
* Start
+
* Stop
  
$OSGEOBUILDHOME/buildbot_start.sh <projectname>
+
  $OSGEOBUILDHOME/buildbot_stop.sh <projectname>
  
* Stop
+
== Copy and edit README ==
  
  $OSGEOBUILDHOME/buildbot_stop.sh <projectname>
+
  $ cp $OSGEOBUILDHOME/admin/README $OSGEOBUILDHOME/<projectname>

Revision as of 16:49, 30 September 2006

Draft

NOTE: This is a very first draft of the How-To Create BuildBot Instance


Prerequisites

First, it's very important to read the BuildBot Configuration document.

Create BuildBot instance step-by-step

Assign new id

New instance id: 0 - 99

Login on the server

ssh buildbot@xblade14-2

Go to OSGEOBUILDHOME

[buildbot@xblade14-2 buildbot]$ cd $OSGEOBUILDHOME

Creating directory for project

New BuildBot instance directory for project, lowercase name:

$ mkdir <projectname>

Create directory for buildmaster

$ mkdir buildmaster

Create directory for buildslave

$ mkdir buildslave

Create buildmaster

Run buildbot to create new buildmaster:

$ buildbot create-master ${OSGEOBUILDHOME}/<projectname>/buildmaster

Create buildslave

$ buildbot create-slave ${OSGEOBUILDHOME}/<projectname>/buildslave MASTERHOST:PORT SLAVENAME PASSWORD

PORT: 15XX where XX is subsequent number of BuildBot instance (between 0-99) SLAVENAME: osgeo-<projectname> PASSWORD: <new password>

Configure BuildBot instance

Edit master.cfg

Run

* Start
 $OSGEOBUILDHOME/buildbot_start.sh <projectname>
* Stop
 $OSGEOBUILDHOME/buildbot_stop.sh <projectname>

Copy and edit README

$ cp $OSGEOBUILDHOME/admin/README $OSGEOBUILDHOME/<projectname>