#Microsoft Cross Platform Build Agent

A cross platform build agent for Microsoft Visual Studio Online (VSO) and Team Foundation Server (TFS). Supported on Mac OSX and Linux.

NOTE: This is for the unreleased build.vnext service which is in preview for a subset of accounts

##Pre-Reqs

###Node and Npm: Mac OSX: Download and install node from nodejs.org

Linux: Install using package manager

From a terminal ensure at least node 0.10 and npm 1.4:

$ node -v && npm -v
v0.10.29
1.4.14

##Agent From Package

Installs the agent installer once globally.

$ sudo npm install vsoagent-installer -g

###Create Agents

From a directory you created for the agent, run the installer. Repeat from different folders for multiple agents.

$ install-vsoagent

##Provide Permissions to Account

Determine which account the agent will run as.

1. Enable alternate credentials for account agent will run builds as.
2. Project Admin UI: (from project, gear upper right)
   • Ensure queue created. Name first default. (elect to create a pool if creating)
3. Collection Admin UI: Security tab,
   • Add user to Project Collection Build Service Accounts (allows agent to write back build data)
4. Account Admin (Control Panel): Agent Pools tab, expand pool
   • Add user to Agent Pool Administrators (allows adding agent to pool)
   • Add user to Agent Pool Service Accounts (allows agent to listen to the build queue)

##Configure Agent

Run the agent from the agent folder. Configuration will ask for the username and password of the account the agent will run as. note: if the agent isn't configured, on first run, it will configure.

$ node vsoagent

Enter poolName(enter sets default) > 
Enter serverUrl > https://contoso.visualstudio.com
...
Config saved
Waiting ...

Change Configuration Later:

$ node configure

##Run as a Service

note: only works on OSX right now

###Install Service

$ sudo node service install
...
Started Successfully

###Check Status

$ sudo node service status
8367	-	com.microsoft.vsoagent

note: output is (pid) (rc) (name)

###Stop

$ sudo node service stop
stop: Success.

###Start

$ sudo node service start
start: Success.

###Contents

OSX:
/Library/LaunchDaemons/vsoagent.{accountName}.{agentName}.plist 

##Building From Source

###Clone the repo

git clone <this repo url>

###Build Pre-reqs

Typescript is compiled using Jake tasks

sudo npm install -g typescript
sudo npm install -g jake

Install remaining pre-reqs (run from root of repo)

npm install

###Build and Create Tar Gzip run jake in the root of the repo

$ jake
...
Package done.

This creates a _tar folder with a tar.gzip. Follow next instructions for tar.

##Agent From Tar Zip Create a directory for the agent. Copy the tar zip into it.

tar xvzf ./vsoxplat.tar.gz
cd agent
sudo npm install

Now you can configure the agent as in instructions above.

Note: You can alternatively build and package independantly

$ jake build
$ jake package

###Run Tests run jake test in the root of the repo

jake test