Skip to content

Latest commit

 

History

History
55 lines (33 loc) · 3.47 KB

README.md

File metadata and controls

55 lines (33 loc) · 3.47 KB

VSTS Cross Platform Agent (.NET Core)

Overview

A cross platform build and release agent for Visual Studio Team Services and Team Foundation Server 2015 and beyond. This will be replacing/combining the existing closed source windows build agent and the existing xplat agent

Supported on Windows, OSX and Linux. Written for the .NET Core CLR as one code base in C#.

Will run all existing tasks (typescript/javascript and powershell) including our in the box and your custom tasks written with our vsts task SDK.

Status

A preview is available for Ubuntu and OSX for VSTS. The current preview is more feature complete than the node agent bringing Auto Update, Cancellation, Run as a svc on OSX and Linux, and Gated support.

What's missing from the preview? On-prem NTLM support is in the works so preview with VSTS. Windows preview coming soon.

Build & Test Preview Release
Apple OSX Build & Test Release 4 v2.100.1 June
Ubuntu Ubuntu Build & Test Release 4 v2.100.1 June
RedHat RedHat Build & Test Release 4 v2.100.1 June
Win Windows Build & Test Preview 1 This Week

Configure Account

VSTS only for now. On-prem coming with NTLM support in the works.

Create a PAT token. Step by Step here

Add the user you created the PAT token for to both:

  1. Agent Pool Administrators (allows to register)
  2. Agent Pool Service Accounts (allows listening to build queue)

Agent Roles

TIPS: You can add to roles for a specific pool or select "All Pools" on the left and grant for all pools. This allows the account owner to delegate build administration globally or for specific pools. More here The PAT token is only used to listen to the message queue for a build job When a build is run, it will generate an OAuth token for the scoped identity selected on the general tab of the build definition. That token is short lived and will be used to access resource in VSTS

Get Started

osx Start OSX ubuntu Start Ubuntu redhat Start RedHat

Configuration

More detailed configuration options are covered here

Contribute

For developers that want to contribute, read here on how to build and test.