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

From OSGeo
Jump to navigation Jump to search
m (Linked Buildbot page)
 
(7 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
See [[Buildbot]] for more information.
 +
 
= Draft =
 
= Draft =
 +
 +
  
 
'''NOTE: This is a very first draft of the How-To Create BuildBot Instance'''
 
'''NOTE: This is a very first draft of the How-To Create BuildBot Instance'''
 +
  
 
----
 
----
Line 10: Line 15:
  
 
= Create BuildBot instance step-by-step =
 
= Create BuildBot instance step-by-step =
 
== Assign new id ==
 
 
New instance id: 0 - 99
 
  
 
== Login on the server ==
 
== Login on the server ==
Line 30: Line 31:
  
 
  $ mkdir <projectname>
 
  $ mkdir <projectname>
 +
 +
== Assign new project id ==
 +
 +
Check [[BuildBot Configuration#Buildmaster_ports|Buildmaster ports]] to learn what is this project identifier used for.
 +
 +
Project '''id''' is a solid number '''0''' to '''99''' which identifies OGeo BuildBot instance for particular project and is used to calculate new TCP port numbers.
 +
 +
$ cd ${OSGEOBUILDHOME}/<projectname>
 +
$ echo ## > ID
 +
 +
where '''##''' is project solid ''id'''.
  
 
== Create directory for buildmaster ==
 
== Create directory for buildmaster ==
Line 37: Line 49:
 
== Create directory for buildslave ==
 
== Create directory for buildslave ==
  
$ mkdir buildslave
+
$ mkdir buildslave
  
 
== Create buildmaster ==
 
== Create buildmaster ==
Line 59: Line 71:
 
== Run ==
 
== Run ==
  
* Start
+
* Start
  
  $OSGEOBUILDHOME/buildbot_start.sh <projectname>
+
$OSGEOBUILDHOME/buildbot_start.sh <projectname>
  
* Stop
+
* Stop
  
  $OSGEOBUILDHOME/buildbot_stop.sh <projectname>
+
$OSGEOBUILDHOME/buildbot_stop.sh <projectname>
  
 
== Copy and edit README ==
 
== Copy and edit README ==
  
 
  $ cp $OSGEOBUILDHOME/admin/README $OSGEOBUILDHOME/<projectname>
 
  $ cp $OSGEOBUILDHOME/admin/README $OSGEOBUILDHOME/<projectname>
 +
 +
[[Category: Infrastructure]]

Latest revision as of 15:08, 15 October 2011

See Buildbot for more information.

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

Login on the server

ssh buildbot@xblade14-2

Go to OSGEOBUILDHOME

See OSGEOBUILDHOME to learn what's this location and environment variable used for.

$ cd $OSGEOBUILDHOME

Creating directory for project

New BuildBot instance directory for project, lowercase name:

$ mkdir <projectname>

Assign new project id

Check Buildmaster ports to learn what is this project identifier used for.

Project id is a solid number 0 to 99 which identifies OGeo BuildBot instance for particular project and is used to calculate new TCP port numbers.

$ cd ${OSGEOBUILDHOME}/<projectname>
$ echo ## > ID

where ##' is project solid id.

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>