How to create new OSGeo BuildBot instance

From OSGeo
Jump to navigation Jump to search

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

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>

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>