リファレンス - カスタム ビルド タスクを拡張機能に統合する

  • [アーティクル]

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

このリファレンスは、Azure DevOps でカスタム ビルド パイプライン タスクを作成して拡張機能と統合する場合に使用します。

ヒント

Azure DevOps 拡張機能 SDK を使用した拡張機能開発に関する最新のドキュメントを確認してください。

カスタム タスク

タスク は、ビルドまたはリリース パイプラインで自動化を定義するための構成要素です。 基本的なビルドとデプロイのシナリオを可能にする組み込みタスクが多数用意されています。 独自のシナリオを構築する前に、これらのシナリオを確認することをお勧めします。 既存のタスクがニーズを満たしていない場合は、カスタム タスクを作成できます。

カスタム ビルド タスク JSON

拡張機能を使用してカスタム ビルドまたはリリース タスクを作成する場合、拡張機能にはビルドまたはリリース タスクごとにファイルが含まれます task.json 。 このファイルには task.json 、ビルドタスクまたはリリース タスクが記述されています。 ビルド システムでは、これを使用して構成オプションをユーザーにレンダリングし、ビルド時に実行するスクリプトを把握します。

ビルド/リリース タスク SDK のドキュメントは GitHub にあります。 具体的には、task.json スキーマに関心がある場合があります。

1 つの拡張機能内に複数のバージョンのビルド/リリース タスクをバンドルする

拡張機能には、ビルド タスクまたはリリース タスクの複数のバージョンを含めることができます。 以前のバージョンのユーザーのサービスを中断することなく、拡張機能の将来のバージョンをロールアウトします。 次の情報は、1 つの拡張機能に複数のバージョンを含むレイアウトを示しています。

従来の拡張機能のレイアウト

  • extensionManifest.json
  • extensionIcon.png
  • Task1
    • task.json
    • icon.png
    • taskScript.ps1

Note

タスク アイコンを設定するときは、次のことが当てはまることを確認します。

  • アイコン名がicon.png
  • アイコンのサイズは 32 x 32 ピクセルです
  • アイコンがファイルと同じ場所にあるtask.json

複数のバージョンのレイアウト

Note

このコードでは、 task.json タスク フォルダー内のファイルを検索し、1 レベル深く検索します。 いずれかのレベルで見つからない場合は、エラー メッセージが表示されます。

  • extensionManifest.json
  • extensionIcon.png
  • Task1
    • Task1V1
      • task.json
      • icon.png
      • taskScript.ps1
    • Task1V2
      • task.json
      • icon.png
      • taskScript.ps1
  • Task2
    • Task2V1
      • task.json
      • icon.png
      • taskScript.ps1
    • Task2V2
      • task.json
      • icon.png
      • taskScript.ps1

ヒント

フォルダーに _build/Tasks/ssrsfilesdeploy V1 と V2 の内容が含まれていることを確認するには、ファイル内にfalse設定matchCopy(item, srcPath, destPath, { noRecurse:しますmake-util.js。