If you installed Linux Agents for VSTS vNext build in the past, you already know that it was a simple experience, especially because the agent was installed with npm, so it is a matter of a couple of commands.

The agent is undergoing a substantial change, and in GitHub there is a project about VSTS Cross Platform Agent (CoreCLR), a new version of the agent, entirely written in CoreCLR that will substitute the closed source Windows agent and the actual XPlat agent. This version of the agent is still work-in-progress, and we can expect a preview for OSX and Linux in the next month. Until now, to run vNext build on linux, you should use the XPlat Agent.

Installing the actual xpPlat agent is really simple, just create a folder where you want to install the agent, open a bash in that folder and then issue the command:

curl -skSL http://aka.ms/xplatagent | bash

This will download an install script, and does everything for you: installing the prerequisite, downloading, and installing everything. At the end of the script you should only execute:

./run.sh

To start configuration of the agent. The official guide suggest you to use Personal Access Token, but standard alternate credentials are fine, if the user is part of the Agent Pool Administrators and Agent Pool Service Account.

Once everything is configured, the agent is ready to run your builds.

Figure 1: Agents configured and running on Linux CentOS machine