contribute.md

Contribute (Dev)

Dev Dependencies

Git for Windows Install Here (needed for dev sh script)

Build, Test, Layout

From src:

dev {command}

./dev.sh {command}

Commands:

layout (l): Run first time to create a full agent layout in {root}/{runtime_id}/_layout

build (b): build everything and update agent layout folder

test (t): build agent binaries, run unit tests applicable to the current platform

Normal dev flow:

git clone https://github.com/microsoft/azure-pipelines-agent
cd ./src
./dev.(sh/cmd) layout # the agent that build from source is in {root}/{runtime_id}/_layout
<make code changes>
./dev.(sh/cmd) build # {root}/{runtime_id}/_layout will get updated
./dev.(sh/cmd) test # run unit tests before git commit/push

Editors

Using Visual Studio 2017
Using Visual Studio Code

Styling

We use the dotnet foundation and CoreCLR style guidelines located here

Troubleshooting build or test problems

'unzip' not found

• if you see this while building or testing on Windows, you need to install unzip for the Windows bash shell
• open a command window, run bash, and run sudo apt install unzip to get that tool installed