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 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>