How to create new OSGeo BuildBot instance

From OSGeo
Jump to: navigation, search

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>