At line 3 changed 1 line. |
<div class="note" style="margin: 5px">__NOTE:__ The main lesson I learned when trying to get this to work is don't use Cygwin. In fact, I recommend you use a *nix machine if you [have one available|http://www.clarkware.com/cgi/blosxom/2004/10/19#TheyNeedABuildMachine] |
<div class="note" style="margin: 5px">__NOTE:__ I recommend setting up CruiseControl on a Linux machine if you [have one available|http://www.clarkware.com/cgi/blosxom/2004/10/19#TheyNeedABuildMachine] |
At line 8 changed 3 lines. |
1. [Download||http://prdownloads.sourceforge.net/cruisecontrol/cruisecontrol-2.2.zip?download] and install CruiseControl. Extract it to your $TOOLS_HOME directory, wherever that may be. |
|
2. After you've installed CruiseControl, create an "appfuse-cc" or similar directory next to your project directory. In my tests, I had: |
1. [Download|http://cruisecontrol.sourceforge.net/download.html] and install CruiseControl 2.4.1. Extract it to your $TOOLS_HOME directory, wherever that may be. |
At line 12 changed 5 lines. |
{{{ |
c:\Source |
c:\Source\appfuse |
c:\Source\appfuse-cc |
}}} |
2. After you've installed CruiseControl, download the following files and put them in the cruisecontrol-2.4.1 ($CC_HOME) directory. |
At line 18 removed 2 lines. |
3. Download the following files and put them in the "appfuse-cc" directory: |
|
At line 21 removed 1 line. |
* [buildstatus.xsl] |
At line 23 removed 1 line. |
* [cruise.sh] |
At line 25 changed 1 line. |
The latest version of these files can be found [in CVS|appfuse.dev.java.net/source/browse/appfuse/extras/cruisecontrol]. |
The latest version of these files can be found [in CVS|https://appfuse.dev.java.net/source/browse/appfuse/extras/cruisecontrol] or in your project's ''extras/cruisecontrol'' directory. |
At line 27 changed 1 line. |
4. Modify cruise.sh to point to the installed directory. If you're on Windows, rename cruise.sh to cruise.bat and point to the cruisecontrol.bat file. |
3. Modify config.xml for your e-mail address and project name. |
At line 29 changed 3 lines. |
5. Modify config.xml for your Ant path and publishing directories. |
|
6. Modify build.xml so it points to your CVS server and project. |
4. Modify build.xml so it points to your CVS server and project. |
At line 33 changed 1 line. |
7. Run "ant" in the current directory or checkout your project into the "checkout" directory (you'll need to create it). You can also run this on the "appfuse" project for testing purposes. |
5. Run "ant" in the current directory or checkout your project into the "projects". |
At line 35 changed 1 line. |
8. Create a "logs/appfuse" directory in the current directory. |
6. Run cruisecontrol.bat (Windows) or cruisecontrol.sh (Unix). |
At line 37 changed 1 line. |
9. Run "cruise.sh". |
%%note __NOTE:__ If you're using Subversion instead of CVS, [download svnant|http://subclipse.tigris.org/servlets/ProjectDocumentList?folderID=1731]. Extract the download into your ''work'' directory, delete everything but it's "lib" directory and adjust the path in build.xml accordingly.%% |
At line 39 changed 1 line. |
10. Tweak the publishers in config.xml to your heart's content. |
I was puzzled why my HTML E-Mails didn't contain all the pretty formatting like Spring's does. Then I looked at their [latest archived one|http://article.gmane.org/gmane.comp.java.springframework.devel/6300] and noticed it looks the same on Gmane as it does in GMail. I'd recommend sending your build notifications to an e-mail account that can be read with a good HTML e-mail reader. |
At line 29 added 1 line. |
If you want to use CruiseControl to build your [Equinox|https://equinox.dev.java.net] project, that's in [Equinox's CVS|https://equinox.dev.java.net/source/browse/equinox/extras/cruisecontrol]. |
At line 42 changed 1 line. |
I was puzzled why my HTML E-Mails didn't contain all the pretty formatting like Spring's does. Then I looked at their [latest archived one|http://article.gmane.org/gmane.comp.java.springframework.devel/6300] and noticed it looks the same on Gmane as it does in GMail. I'd recommend sending your build notifications to an e-mail account that can be read with a good HTML e-mail reader. |
!!Setup CruiseControl Daemon |
After getting all the above working, I setup CruiseControl to run as a daemon. I has some issues with getting [these instructions|http://confluence.public.thoughtworks.org/display/CC/RunningCruiseControlFromUnixInit] working, so I [pinged the mailing list|http://www.nabble.com/forum/ViewPost.jtp?post=3195390&framed=y]. After a few back-and-forth e-mails, the following solution worked for me on Suse 10. |
At line 34 added 104 lines. |
* Create an /etc/init.d/cruisecontrol script with the following script. Make sure and chmod +x /etc/init.d/cruisecontrol. |
<div style="margin-left: 40px"> |
{{{ |
#!/bin/sh |
#content of /opt/cruisecontrol/init script |
# chkconfig: 345 99 05 |
# description: CruiseControl build loop (see /home/tools) |
|
# based on http://confluence.public.thoughtworks.org/display/CC/RunningCruiseControlFromUnixInit |
# adapted for multiple projects |
|
# |
# Cruise Control startup: Startup and kill script for Cruise Control |
# |
|
PATH=/sbin:/usr/sbin:/usr/bin:/bin |
export PATH |
|
NAME=cruisecontrol |
DESC="CruiseControl 2.2 continuous integration build loop" |
|
CC_USER=mraible |
CC_WORK_DIR=/opt/tools/cruisecontrol |
CC_INSTALL_DIR=/opt/tools/cruisecontrol |
|
CC_DAEMON=$CC_INSTALL_DIR/cruise.sh |
CC_CONFIG_FILE=$CC_WORK_DIR/config.xml |
CC_LOG_FILE=$CC_WORK_DIR/cruisecontrol.log |
CC_PORT=8082 |
CC_RMIPORT= |
CC_COMMAND="$CC_DAEMON -configfile $CC_CONFIG_FILE -port $CC_PORT -rmiport $CC_RMIPORT" |
|
# overwrite settings from default file |
if [ -f /etc/default/cruisecontrol ]; then |
. /etc/default/cruisecontrol |
fi |
|
test -f $CC_DAEMON || exit 0 |
|
if [ `id -u` -ne 0 ]; then |
echo "Not starting/stopping $DESC, you are not root." |
exit 4 |
fi |
|
# PPID is read-only in my shell - GNU bash, version 2.05b.0(1)-release (i586-mandrake-linux-gnu) |
PARPID=`ps -ea -o "pid ppid args" | grep -v grep | grep "${CC_DAEMON}" | sed -e 's/^ *//' -e 's/ .*//'` |
|
if [ "${PARPID}" != "" ] |
then |
PID=`ps -ea -o "pid ppid args" | grep -v grep | grep java | grep "${PARPID}" | \ |
sed -e 's/^ *//' -e 's/ .*//'` |
fi |
|
case "$1" in |
|
'start') |
# going into the work dir allows for use of relative PATHs in the config file |
cd $CC_WORK_DIR |
su $CC_USER -c "$CC_COMMAND >> $CC_LOG_FILE 2>&1" & RETVAL=$? |
echo "$NAME started with jmx on port ${CC_PORT}" |
;; |
|
'stop') |
if [ "${PID}" != "" ] |
then |
kill -9 ${PID} ${PARPID} |
$0 status |
RETVAL=$? |
else |
echo "$NAME is not running" |
RETVAL=1 |
fi |
;; |
|
'status') |
# echo PARPIDs $PARPID |
# echo PIDs $PID |
kill -0 $PID >/dev/null 2>&1 |
if [ "$?" = "0" ] |
then |
echo $NAME \(pids $PARPID $PID\) is running |
RETVAL=0 |
else |
echo "$NAME is stopped" |
RETVAL=1 |
fi |
;; |
|
'restart') |
$0 stop && $0 start |
RETVAL=$? |
;; |
|
*) |
echo "Usage: $0 { start | stop | status | restart }" |
exit 1 |
;; |
esac |
#echo ending $0 $$.... |
exit 0; |
}}} |
</div> |
|
That's it - you should be able to run /etc/init.d/cruisecontrol as root and CC will check for new updates every hour. |