Skip to content

buildfarm/bfmgr

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

30 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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