[svn-commits] russell: testsuite/bamboo/trunk r364 - /bamboo/trunk/README.txt

[SVN commits to the Digium repositories]

Author: russell
Date: Mon Jun  7 14:49:22 2010
New Revision: 364

URL: http://svnview.digium.com/svn/testsuite?view=rev&rev=364
Log:
Add some bamboo agent config info

Modified:
    bamboo/trunk/README.txt

Modified: bamboo/trunk/README.txt
URL: http://svnview.digium.com/svn/testsuite/bamboo/trunk/README.txt?view=diff&rev=364&r1=363&r2=364
==============================================================================
--- bamboo/trunk/README.txt (original)
+++ bamboo/trunk/README.txt Mon Jun  7 14:49:22 2010
@@ -12,7 +12,8 @@
 --------------------------------------------------------------------------------
 
         1) Introduction
-        2) Test Slave Configuration
+        2) Test Slave Setup
+        3) Bamboo Agent Configuration
 
 --------------------------------------------------------------------------------
 --------------------------------------------------------------------------------
@@ -30,7 +31,7 @@
 --------------------------------------------------------------------------------
 
 --------------------------------------------------------------------------------
---- 2) Test Slave Configuration
+--- 2) Test Slave Setup
 --------------------------------------------------------------------------------
 
         This section discusses what is necessary to configure a system to be a
@@ -45,6 +46,39 @@
 will assume are installed on an agent.  They will be installed into
 /usr/local/bin/bamboo/.  To install them, run "make install" as root.
 
+        Finally, the machine must have Sun Java installed to be able to run the
+Bamboo client application.
+
+--------------------------------------------------------------------------------
+--------------------------------------------------------------------------------
+
+--------------------------------------------------------------------------------
+--- 3) Bamboo Agent Configuration
+--------------------------------------------------------------------------------
+
+        Once a system has been set up to be able to build and test Asterisk,
+then it must be added as a remote agent in Bamboo.  This is done through the
+Bamboo administration page.  In the admin interface, go to the "Agents" section.
+Under Remote Agents, there is a "Install Remote Agent" link.  Bamboo will
+provide instructions to run a command such as this one:
+
+# java -jar atlassian-bamboo-agent-installer-2.5.1.jar \
+>    http://bamboo.asterisk.org/agentServer/
+
+        Add "-Dbamboo.home=/srv/bamboo" to the command that is provided.  For
+example:
+
+# java -Dbamboo.home=/srv/bamboo -jar atlassian-bamboo-agent-installer-2.5.1.jar \
+>    http://bamboo.asterisk.org/agentServer/
+
+        Once the agent has connected, the Bamboo administration interface can be
+used to set custom capabilities.  Capabilities on agents are used in combination
+with requirements on build plans to match up build plans with remote agents that
+are capable of executing them.  Right now, capabilities of "asterisk-linux",
+"asterisk-freebsd", and "asterisk-osx" are used on remote agents to allow build
+plans to run on a specific OS.  However, the capabilities and requirements
+system is very flexible and could be used for other things.
+
 --------------------------------------------------------------------------------
 --------------------------------------------------------------------------------