設定 ALM Accelerator 管線

管線是 ALM Accelerator 的引擎。 它們自動化了 Power Platform 的 ALM 程序。 它們是使用 Azure Pipelines (一種 Azure DevOps 服務) 組建，並儲存在 Azure DevOps 專案中。

四個主要管線用於自動化 ALM 程序：

• Import
• Export
• 删除
• 建置/部署

這些管線設計用於與 ALM Accelerator 畫布應用程式一起使用。 您不需要使用該應用程式，但我們推薦您使用。 該應用提供了用於叫用管線的簡單介面，以及無需瞭解基礎參數即可設定管線的方法。

常見 ALM Accelerator 管線場景

ALM Accelerator 管線和應用程式都有預設設定，可讓您快速開始使用 Power Platform 的 ALM。 管線可以涵蓋許多不同的 ALM 場景，以滿足組織的要求。 以下幾節會介紹一些常見場景，以及如何透過 ALM Accelerator 應用程式中的管線設定、部署設定檔和步驟或直接透過管線來涵蓋這些場景。

在一個專案中安裝管線，在另一個專案中安裝原始程式碼

在 ALM Accelerator 應用程式和部署設定檔中，您可以指定管線專案和來源專案。 安裝精靈中的選項可讓您指定單獨的管線專案和存放庫。 如果要根據使用者、公司結構或其他因素對解決方案的儲存體進行細分，則這些選項非常有用。 在大多數情況下，管線 YAML 檔案儲存在管線專案中，匯出、匯入和刪除管線是在解決方案受原始檔控制的專案中建立。

在沒有 ALM Accelerator 的情況下執行管線

ALM Accelerator 畫布應用程式提供了一個用於執行管線的簡單按鈕層。 但是，您不需要該應用程式來執行它們。 如果您想使用獨立於應用程式的管線，請直接從命令列執行它們。 您也可以組建自己的應用程式。 使用 ALM Accelerator 解決方案中包含的 Azure DevOps API 的自訂連接器，以使用 Power Automate 或其他 Power Platform 技術叫用管線。

無論哪種情況，如果要獨立使用管線，關鍵是要了解傳遞給它們的參數。

管線參數

import-unmanaged-to-dev-environment 的參數： 使用導入解決方案管道將非託管解決方案從原始程式碼控制導入到開發環境。

下表描述了匯入管線的參數。

delete-unmanaged-solution-and-components 的參數： 使用 delete solution 管道從開發環境中刪除非託管解決方案及其所有元件。

下表描述了刪除管線的參數。

export-solution-to-git 的參數： 使用導出解決方案管道將解決方案導出到 Git 儲存庫。

下表描述了匯出管線的參數。

使用 ALM Accelerator 管線匯出或部署解決方案時，自訂解決方案的版本設定

根據預設，匯出和部署的解決方案使用部署管線 YAML 檔案中指定的名稱進行版本設定。 但是，ALM Accelerator 管線可讓您在匯出或部署解決方案時，自訂解決方案的版本設定。 以下幾節會說明您可以使用的方法。

匯出版本設定

請使用管線匯出的版本號碼，做為所有部署環境中的版本號碼。 在匯出管線中建立一個名為 UseSolutionVersionFromDataverse 的變數，或者在 ALM Accelerator 的變數庫中建立一個全域變數。 為其指定值 True。 該變數可確保解決方案中匯出的版本號碼保留在下游環境中，並在提交解決方案來源時反映在原始檔控制中。

自訂版本設定邏輯

使用 ALM Accelerator 勾點來設定解決方案的版本。 將自訂邏輯新增至 build-solution-pack-pre-hook.yml 範本，以直接操縱 Solution.xml 或使用其他工具 (如 pac 解決方案版本 )。

自訂 bring-your-own-templates 版本設定

使用自己的範本來產生部署管線的能力，可讓您在初始解決方案匯出期間有足夠的靈活性。 例如，建立 build-deploy-validation/test/prod-SampleSolution.yml 複本，並將組建名稱從預設值變更為根據設定執行或組建編號 的版本設定策略：

build:
  - name: 1.0.$(Date:yyyyMMdd)$(Rev:.r)
    ...

範本就緒後，在部署設定檔中更新部署步驟以指向它們。

自訂管線中的部署步驟數以及目標環境的名稱

與使用範本的自訂版本設定類似，使用自己的範本來產生部署管線的能力在解決方案的初始匯出期間提供了更大的靈活性。 指定範本所在的專案，以及要用來產生部署管線的範本路徑。 專案和路徑的設定位於 ALM Accelerator 管理應用程式「部署設定檔」和「部署步驟」資料表中。

範本的路徑相對於匯出管線位置的根目錄。 例如，預設驗證環境部署管線範本的路徑為 /Pipelines/build-deploy-validation-SampleSolution.yml。 若要在與匯出管線相同的專案中使用範本，請將路徑指定為 /Pipelines/build-deploy-validation-MyCustomTemplate.yml。

下表說明了範本中用於產生部署管道時，取代特定解決方案值的預留位置。

建議您複製 build-deploy-validation/test/prod-SampleSolution.yml 管線範本以開始使用您自己的自訂範本。

在管線中執行自訂步驟，而無需修改預設範本

ALM Accelerator 管線範本具有多個擴充點 (或勾點)，您可以使用它來自訂管線，同時在升級案例中將合併衝突降至最低。 瞭解有關 ALM 加速器挂鉤的更多資訊。

打開或關閉管線中的特定動作

管線會使用變數來確定是否應該執行工作，或者要執行幾個工作。 下表說明您可以為單一管線設定的變數，或是透過 alm-accelerator-variable-group 設定所有管線的變數。

後續步驟