/vso-agent-tasks

Build and Release Tasks for Visual Studio Online and Team Foundation Server

Primary LanguagePowerShellMIT LicenseMIT

VSO: ![VSO] (https://mseng.visualstudio.com/DefaultCollection/_apis/public/build/definitions/b924d696-3eae-4116-8443-9a18392d8544/1474/badge)

VSO DevOps Tasks


![Tasks](/taskbanner.png?raw=true "Tasks")
## Configure

Before you run the builds, you need to configure an agent:

Windows: Use the hosted pool or bring your own

OSX/Linux

Overview

This repo contains the tasks that are provided out of the box with Visual Studio Online and Team Foundation Server.

This provides open examples on how we write tasks which will help you write other tasks which can be uploaded to your account or server. See writing tasks below.

How to Use Tasks

Visual Studio Build: How To

Build and Deploy ASP.NET5 Web App How To

Publish Build Artifacts

Publish artifacts to a server or share from a copy root. Supports multiple lines of minimatch patterns.

Examples:

**/bin/**
out/package.zip
out/**/*.zip
$(agent.builddirectory)/out/pkg?(2|1).zip

more examples

Azure Website Deployment: How To

Azure PowerShell: How To

Xcode Build: How To

Writing Tasks

Before writing a task, consider simply customizing your build using the script running tasks such as PowerShell or shell scripts. That is often the most appropriate path.

Tasks are simply tool runners. They know how to run MSBuild, VSTest, etc... in a first class way and handle return codes, how to treat std/err out, and how to write timeline records based on expected output. They also get access to credentials to write back to VSO/TFS.

For uploading custom tasks to VSO use the TFS Cross Platform Command Line utility.

Tasks can also be deployed with an Visual Studio Team Service Extension. See this tutorial how to package tasks inside an extension.

Contributing

We take contributions. Read here how to contribute.