README.md

Azure DevOps Extension Task Example

Overview

This repository is for me to see how to build, test, package and publish an Azure DevOps Extension.

The shovel/shovel.py holds the actual tasks that are performed to build and publish the ADO Extension. The Tasks being created are stored in tasks/. This is useful for making an Extension with multiple tasks.

Requirements

• NodeJS + TypeScript
  • Windows: nvm-windows
  • Linux/MacOS: nvm-sh
• Python 3 + pip (For the shovel task runner)

Setup

Install the Python 3 dependencies:

python -m pip install --upgrade pip
python -m pip install -r python-3-requirements.txt

Then build the package.

shovel build

This will cd tasks/buildAndReleaseTask/ then execute ./node_modules/.bin/tsc via npm's s script functionality.

Usage

Package the ADO Extension

shovel package

This will execute the tfx CLI client to package the ADO Extension.

References

• Microsoft Azure DevOps: Create Custom Agent Task
• Microsoft Azure DevOps: azure-pipelines-task-lib Reference
• Microsoft Azure DevOps: Custom Task Folder Structures
• Microsoft Azure DevOps: vss-extension.json Schema
• Microsoft Azure DevOps: Create Custom Server Task