Difference between revisions of "How to create new OSGeo BuildBot instance"
Jump to navigation
Jump to search
Wiki-Mloskot (talk | contribs) (First draft of this HOWTO) |
Wiki-Mloskot (talk | contribs) m (Linked Buildbot page) |
||
| (11 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
| + | See [[Buildbot]] for more information. | ||
| + | |||
= Draft = | = Draft = | ||
| + | |||
| + | |||
'''NOTE: This is a very first draft of the How-To Create BuildBot Instance''' | '''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@[[BuildBot Configuration#Server|xblade14-2]] | ||
| + | |||
| + | == Go to OSGEOBUILDHOME == | ||
| + | |||
| + | See [[BuildBot Configuration#OSGEOBUILDHOME|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> | + | $ mkdir <projectname> |
| − | + | == Assign new project id == | |
| − | + | Check [[BuildBot Configuration#Buildmaster_ports|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 == | |
| − | buildbot create-slave ${OSGEOBUILDHOME}/<projectname>/buildslave MASTERHOST:PORT SLAVENAME PASSWORD | + | $ 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) | PORT: 15XX where XX is subsequent number of BuildBot instance (between 0-99) | ||
| Line 37: | Line 65: | ||
PASSWORD: <new password> | PASSWORD: <new password> | ||
| − | + | == Configure BuildBot instance == | |
| − | + | Edit master.cfg | |
| − | + | == Run == | |
* Start | * Start | ||
| Line 50: | Line 78: | ||
$OSGEOBUILDHOME/buildbot_stop.sh <projectname> | $OSGEOBUILDHOME/buildbot_stop.sh <projectname> | ||
| + | |||
| + | == Copy and edit README == | ||
| + | |||
| + | $ cp $OSGEOBUILDHOME/admin/README $OSGEOBUILDHOME/<projectname> | ||
| + | |||
| + | [[Category: Infrastructure]] | ||
Latest revision as of 15:08, 15 October 2011
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>