Buildfarm Manager

This repository hosts the Buildfarm deployment and administration application.

Quick Start

Local Testing

Make sure Docker is running

Create log directory

sudo mkdir /var/log/bfmgr && sudo chmod 0777 /var/log/bfmgr

Build and run from source

./mvnw clean package && java -jar target/bfmgr-<REL NUMBER>.jar

Download and run a binary release

rel=<RELEASE_NUMBER>
wget https://github.com/80degreeswest/bfmgr/releases/download/$rel/bfmgr-$rel.jar
java -jar bfmgr-$rel.jar

Local Testing via AWS

To run Buildfarm Manager on your local machine, but deploy Buildfarm in AWS, authenticate to AWS, the run bfmgr with the following tags:

java -jar bfmgr-$rel.jar --deploy aws --region us-east-1

If your AWS account requires specific tags (including mandatory asset tags) you can pass them as follows:

java -jar bfmgr-$rel.jar --deploy aws --region us-east-1 --tags "Tag1=Value1,Tag2=Value2" --asset "Asset"

Go to http://localhost and click Create

Deploying in AWS

Run below CloudFormation template in your AWS account

https://github.com/80degreeswest/bfmgr/blob/master/src/main/resources/bfmgr-aws.json

Alternatively, manually launch an EC2 instance with the IAM Role with specified policies and run the following

yum install java -y
rel=<RELEASE_NUMBER>
region=us-east-1
wget -N https://github.com/80degreeswest/bfmgr/releases/download/$rel/bfmgr-$rel.jar
mkdir /var/log/bfmgr && chmod 0777 /var/log/bfmgr
java -jar bfmgr-$rel.jar --region $region &
disown

Go to http://<INSTANCE_IP> and click Create
Enter desired Subnet ID and Security Group and click Create
You should have a working Buildfarm cluster setup in under 5 minutes