Installing and Configuring a Build Agent
First, {{{http://continuum.apache.org/download.html}download}} the Continuum Build Agent standalone
distribution or webapp.
* Standalone
The Build Agent is available as a separate standalone Jetty-bundled
webapp. Installing it is as simple as extracting it to a preferred
directory.
The Build Agent runs on a specific port (defaulting to 8181), so it is possible
to install multiple Build Agents in one machine. It is also possible to
install Slaves in the same machine as the Master. To configure the Build Agent
to run using a different port, edit the
<<<$CONTINUUM_BUILDAGENT_HOME/conf/jetty.xml>>> file.
Another configuration file to look at is the
<<<$CONTINUUM_BUILDAGENT_HOME/conf/continuum-buildagent.xml>>>. This file must
be manually edited, as there is no web interface for configuration.
+--------------+
/path/to/build/agent/data/build-output-directory
/path/to/build/agent/data/working-directory
http://builds.example.com:8080/continuum/master-xmlrpc
Maven 2 Home
maven2
/Applications/apache-maven-2.0.9
+----------------+
A minimal configuration will have the following fields:
* <<>> - similar to the build output directory of Continuum
* <<>> - similar to the working directory of Continuum
* <<>> - the url pointing to the XML-RPC context of the Master Build Agent
* <<>> - a list of the installations available on the build agent, including Maven, Ant, JDK, etc.
Note that all of your agents need to be identical, as there is no way to control which agent Continuum chooses.
In addition, if you are using the Continuum Release functionality, the master needs to match the agents, as releases
will be executed on the master.
Now start the Build Agent by executing the startup script available in
<<<$CONTINUUM_BUILDAGENT_HOME/bin/>>>. For example:
<<>> (or <<>> on Windows).
Next, enable the Distributed Builds option in the {{{../administrator_guides/configuration.html}General Configuration}},
and {{{../administrator_guides/build-agents.html}add the agent}} to the Continuum master server.
TODO: Does the Jetty bundle still want CONTINUUM_BUILDAGENT_HOME set?
* Webapp
The build agent is also available as a web application which you can install into your own container.
The build agent needs two things in order to function properly: A CONTINUUM_BUILDAGENT_HOME environment variable,
and a continuum-buildagent.xml configuration file in $CONTINUUM_BUILDAGENT_HOME/conf.
First, set the environment variable:
export CONTINUUM_BUILDAGENT_HOME=/path/to/build/agent/home
or
set CONTINUUM_BUILDAGENT_HOME=c:\path\to\build\agent\home
Next, create the continuum-buildagent.xml file as shown above, and save it in $CONTINUUM_BUILDAGENT_HOME/conf.
You will need to create these directories.
Finally, drop the webapp into your container, and start it.