參考 - 將自定義建置工作整合到延伸模組中

  • 發行項

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架構感興趣。

將多個版本的組建/發行工作組合在一個延伸模組內

您可以在延伸模組中包含多個組建或發行工作版本。 推出延伸模組的未來版本，而不會中斷舊版用戶的服務。 下列信息顯示一個延伸模組中有多個版本的版面配置。

傳統延伸模組版面配置

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

注意

當您設定工作圖示時，請確定下列專案為 true。

  • 圖示名稱icon.png
  • 圖示大小為32x32圖元
  • 圖示位於與檔案相同的位置task.json

多個版本配置

注意

程序代碼會在工作資料夾內尋找 task.json 檔案，然後更深入一層。 如果在任一層級中找不到其中一個，您會看到錯誤訊息。

  • 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 內容，請將 設定matchCopy(item, srcPath, destPath, { noRecurse:false為檔案中的 make-util.js 。