contribute.md

Contribute to the Microsoft Cross Platform Build Agent

In order to contribute, you will need to be able to build the source, deploy to test and run automated tests. Please fork and send pull requests.

Building From Source

Clone the repo

git clone https://github.com/Microsoft/vso-agent.git

Build Pre-reqs

Gulp is the build engine. The cli needs to be installed globally

sudo npm install -g gulp

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

sudo npm install

Build

run gulp in the root of the repo

$ gulp
...
[22:58:35] Finished 'default' after 2.39 s

This creates a _package which is what is pushed to npm.

Install from _package

This installs from a local package instead of pulling from npm.

cd _package
$ sudo npm install ./vsoxplat -g

Go to Create Agent instructions

Run Tests

To have the best coverage, these should be run from an OSX machine with Xcode and all the java tools. If toolsets for the relevant tests are not present, they will noop.

Run all suites:

gulp test

Test agent and tasks:

gulp test --suite builds

Test vso-task-lib:

gulp test --suite tasklib