How to create new OSGeo BuildBot instance

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 BuildBot Configuration#OSGEOBUILDHOME section to learn what's OSGEOBUILDHOME 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>