Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
若要在 Azure DevOps 中创建自定义生成管道任务并将其与扩展集成,请使用此参考。
小窍门
查看有关使用 Azure DevOps 扩展 SDK 进行扩展开发的最新文档。
自定义任务
任务是用于定义生成或发布管道中的自动化的构建基块。 若要了解详细信息,请参阅 任务类型和使用情况。
我们提供了许多 内置任务 来启用基本的生成和部署方案。 我们建议在创建自己的场景之前查看这些场景。 如果现有任务不满足需求,可以生成 自定义任务。
自定义生成任务 JSON
使用扩展创建自定义生成或发布任务时,该扩展包含每个生成或发布任务的 task.json 文件。 task.json 文件描述生成或发布任务。 生成系统使用它向用户呈现配置选项,并知道在生成时要执行的脚本。
若要了解详细信息,请参阅 GitHub 上的 生成和发布任务 SDK 文档 。 具体而言,你可能对 task.json 架构感兴趣。
在一个扩展中捆绑多个版本的生成或发布任务
可以在扩展中包含多个版本的生成或发布任务。 在不中断旧版本用户服务的情况下推出扩展的未来版本。 以下信息展示了如何在一个扩展中创建多个版本的布局。
传统扩展布局
- extensionManifest.json
- extensionIcon.png
- 任务 1
- task.json
- icon.png
- taskScript.ps1
注释
设置任务图标时,请确保满足以下条件。
- 图标名称 icon.png
- 图标大小为 32x32 像素
- 该图标与task.json文件位于相同的位置
多个版本布局
注释
代码在任务文件夹中查找 task.json 文件,然后查找更深层次的文件。 如果在任一级别中找不到一个,则会看到一条错误消息。
- extensionManifest.json
- extensionIcon.png
- 任务 1
- Task1V1
- task.json
- icon.png
- taskScript.ps1
- Task1V2
- task.json
- icon.png
- taskScript.ps1
- Task1V1
- 任务 2
- Task2V1
- task.json
- icon.png
- taskScript.ps1
- Task2V2
- task.json
- icon.png
- taskScript.ps1
- Task2V1
小窍门
若要确保 _build/Tasks/ssrsfilesdeploy 文件夹包含 V1 和 V2 内容,请在 make-util.js 文件中将 matchCopy(item, srcPath, destPath, { noRecurse:
设置为 false
。