https://github.com/angr1st/custombuildtask
This is a minimal Example of a azure devops extension containing a simple build task that uses the powershell3 task executer.
https://github.com/angr1st/custombuildtask
azure-devops-extension powershell
Last synced: 6 months ago
JSON representation
This is a minimal Example of a azure devops extension containing a simple build task that uses the powershell3 task executer.
- Host: GitHub
- URL: https://github.com/angr1st/custombuildtask
- Owner: Angr1st
- License: mit
- Created: 2020-04-14T22:23:59.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2020-05-05T23:11:21.000Z (almost 6 years ago)
- Last Synced: 2025-10-12T16:06:48.407Z (6 months ago)
- Topics: azure-devops-extension, powershell
- Language: PowerShell
- Homepage:
- Size: 1.43 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Azure DevOps CustomBuildTask
This Repo contains a really simple azure devops extension with just one build task. This build task uses the new PowerShell3 Task Executer. You can use this structure as template to create your own azure devops extension. This custom build task showcased here is only intended to be run on a windows machine.
## Prerequisites
Have a look at microsofts [tutorial](https://docs.microsoft.com/en-us/azure/devops/extend/develop/add-build-task?view=azure-devops#preparation-and-required-setup-for-this-tutorial) of how to create a custom build task. There they list everything needed to create and publish a custom build task.
## How To Adapt
1. Update the information inside of the [vss-extension.json](/vss-extension.json)
2. Update the information inside of the [task.json](/TestTask/task.json)
3. Potentially look for an updated version of the [VstsTaskSdk](https://www.powershellgallery.com/packages/VstsTaskSdk) (current: 0.11.0)
- Replace the content inside of the [VstsTaskSdk-Folder](/TestTask/ps_modules/VstsTaskSdk) with the new content
- Send me a pr to update this repo 😅
4. Remove the [MinApp-Folder](/TestTask/MinApp)
5. Update the [task.ps1](/TestTask/task.ps1) script for your purpose
- Revisit the [task.json](/TestTask/task.json) and make sure your inputs match your VstsInputs. If you messed this up and you need to do a breaking change (remove an input) then you need to increment the major version of the [task.json](/TestTask/task.json).
6. Replace the icons [here](/images/logo.png) for the extension and [here](/TestTask/icon.png). Both need to be 128x128.
## How to package and publish
You can use the [pack_and_publish.ps1](/pack_and_publish.ps1) script to automate the publishing of your newly created extension. You can also pass in an organisation to share your extension with. It will be published privately by default.
## History
After I fixed the ps_module folder structure (removing the 0.11.0 and moving its contents directly into its parent folder) the build task works.
Also the task.ps1 shows you how to run another app using start-process cmdlet and using the correct options to retrieve its ExitCode.