How to create new OSGeo BuildBot instance

From OSGeo
Jump to navigation Jump to 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>
Retrieved from "http://wiki.osgeo.org/w/index.php?title=How_to_create_new_OSGeo_BuildBot_instance&oldid=58037"