Differences

This shows you the differences between two versions of the page.

--- dev:testing:buildbot [2011/03/01 16:43] – Track subversion as a dependency for buildbot slaves dbs
+++ dev:testing:buildbot [2022/02/10 13:34] (current) – external edit 127.0.0.1
@@ Line 3: / Line 3: @@
 [[http://buildbot.net|buildbot]] is a continuous integration server that checks the quality of the OpenSRF and Evergreen build trees after every commit.
-The build results are visible at http://testing.evergreen-ils.org/buildbot
+The build results are visible at http://testing.evergreen-ils.org/buildbot/
 ===== Setting up the buildbot master =====
-  - easy_install buildbot  (note that some patches are necessary for improved pylint support)
+  - Install buildbot prereqs: http://buildbot.net/buildbot/docs/current/manual/installation.html
-    - Create the buildmaster (skip this if you're just setting up a build slave):
+  - Install buildbot with ''easy_install buildbot''  (note that some patches are necessary for improved pylint support)
-    - adduser buildmaster
+  - Create the buildmaster (skip this if you're just setting up a build slave):
-    - su - buildmaster
+    - ''adduser buildmaster''
-    - buildbot create-master
+    - ''su - buildmaster''
-    - cp OpenSRF/examples/buildbot.cfg /home/buildmaster/master.cfg
+    - Initialize the buildmaster directory (where //opensrf-build// represents the directory of the build instance): ''buildbot create-master'' //opensrf-build//
-    - set slavePortnum
+    - ''cp OpenSRF/examples/buildbot.cfg /home/buildmaster/opensrf-build/master.cfg''
-    - buildbot start
+    - ''set slavePortnum''
+===== Starting the buildbot master =====
+To start the buildbot master:
+    - ''su - buildmaster''
+    - Start the build instance, where //opensrf-build// represents the build directory: ''buildbot start'' //opensrf-build//
 ===== Setting up the buildbot slave =====
@@ Line 20: / Line 29: @@
 If you want to contribute a buildbot slave to the testing pool, contact Dan Scott for the port, buildslave name, and buildslave password that you should use to connect to the buildmaster.
-  - Install ''subversion'' - it's a prerequisite for actually running the builds once the slave is up and running.
+==== Hardware prerequisites ====
+A server with 16 GB of disk space and 512 MB of RAM should be plenty for a buildbot slave.
+==== Firewall prerequisites ====
+Your buildbot slave needs to be able to initiate an outbound connection to a port on testing.evergreen-ils.org, but does not need to allow any inbound connections (other than for your own administrative purposes, naturally!).
+==== Steps ====
+  - Install ''git'' - it's a prerequisite for actually running the builds once the slave is up and running.
   - Download OpenSRF.
     - (//OpenSRF buildslave//): Just install the prerequisites from OpenSRF's Makefile.install to satisfy build dependencies.
@@ Line 30: / Line 49: @@
     - adduser openslave
     - su - openslave
-    - buildslave create-slave opensrf-slave localhost:9999 opensrf-slave XXX
+    - buildslave create-slave opensrf-slave localhost:<port-number> opensrf-slave <password>
+    - Edit ''opensrf-slave/info/admin'' and change the administrator name / email address to your own
     - buildslave start opensrf-slave