Azure DevOps Services |Azure DevOps Server 2022 および Azure DevOps Server 2019
このリファレンスは、カスタム ビルド パイプライン タスクを作成し、Azure DevOps の拡張機能と統合する場合に使用します。
ヒント
Azure DevOps Extension SDK を使用した拡張機能開発に関する最新のドキュメントを確認してください。
カスタムタスク
タスクは、ビルド パイプラインまたはリリース パイプラインで自動化を定義するための構成要素です。 詳細については、「 タスクのタイプと使用状況」を参照してください。
基本的なビルドとデプロイのシナリオを可能にするために、多くの 組み込みタスク を提供しています。 独自のシナリオを構築する前に、これらのシナリオを確認することをお勧めします。 既存のタスクがニーズを満たさない場合は、 カスタムタスクを作成できます。
カスタムビルドタスクJSON
拡張機能を使用してカスタム ビルド タスクまたはリリース タスクを作成すると、拡張機能には各ビルド タスクまたはリリース タスクの task.json ファイルが含まれます。 task.json ファイルには、ビルド タスクまたはリリース タスクが記述されています。 ビルドシステムはこれを使用して、構成オプションをユーザーにレンダリングし、ビルド時に実行するスクリプトを認識します。
詳細については、GitHub の ビルドおよびリリース タスク SDK のドキュメント を参照してください。 具体的には、 task.json スキーマに関心があるかもしれません。
ビルドまたはリリースタスクの複数のバージョンを 1 つの拡張機能にバンドル
拡張機能内には、ビルド タスクまたはリリース タスクの複数のバージョンを含めることができます。 拡張機能の将来のバージョンをロールアウトし、古いバージョンのユーザーのサービスを中断しません。 次の情報は、1 つの拡張機能に複数のバージョンを含めるためのレイアウトを示しています。
従来の拡張レイアウト
- extensionManifest.json
- extensionIcon.png
- タスク1
- task.json
- icon.png
- taskScript.ps1
注
タスクアイコンを設定するときは、次の点を確認してください。
- アイコン名は icon.png
- アイコンのサイズは 32x32 ピクセルです
- アイコンは task.json ファイルと同じ場所にあります
複数バージョンのレイアウト
注
このコードは、タスク フォルダ内で task.json ファイルを検索し、次に 1 レベル深く探します。 どちらのレベルでも見つからない場合は、エラー メッセージが表示されます。
- extensionManifest.json
- extensionIcon.png
- タスク1
- タスク1V1
- task.json
- icon.png
- taskScript.ps1
- タスク1V2
- task.json
- icon.png
- taskScript.ps1
- タスク1V1
- タスク2
- タスク2V1
- task.json
- icon.png
- taskScript.ps1
- タスク2V2
- task.json
- icon.png
- taskScript.ps1
- タスク2V1
ヒント
_build/Tasks/ssrsfilesdeploy フォルダに V1 と V2 の内容が含まれていることを確認するには、make-util.js ファイルで matchCopy(item, srcPath, destPath, { noRecurse: を false に設定します。