使用模板自定义部署管道

ALM 加速器包括现成的管道,用于根据默认环境和分支策略部署到环境。 您可以使用“创建自己的模板”(BYOT) 方法轻松自定义 ALM 加速器管道。 BYOT 允许您根据分支策略控制触发部署的因素。 BYOT 还允许您为默认验证、测试和生产环境以外的环境创建管道。

本文中描述的场景自定义管道模板以包含新的验收环境,只是可以使用 BYOT 方法实现的很多可能的场景之一。

使用 BYOT 自定义部署管道

当您安装 ALM Accelerator for Power Platform 时,CoE 初学者工具包 GitHub 存储库中的管道模板将被复制到您的 Azure DevOps Git 存储库。 使用您自己的管道模板副本,您可以对其进行更改,而不会受我们存储库中更改的影响或影响解决方案的升级路径。

下表介绍了复制到您的 Azure DevOps Git 存储库的三个部署管道模板。

管道模板 说明 GitHub 位置
build-deploy-validation-SampleSolution.yml 验证环境部署管道 链接
build-deploy-test-SampleSolution.yml 测试环境部署管道 链接
build-deploy-prod-SampleSolution.yml 生产环境部署管道 链接

指示 ALM 加速器在生成部署管道时使用自定义模板。 您可以使用它们将解决方案部署到默认验证、测试和生产环境以外的环境,或者部署到要添加的任何其他自定义功能中。

管道模板中的占位符

管道模板包括模板位置的占位符和用于部署管道的全局变量组。 您不需要更改这些值。 ALM 加速器创建部署管道时会更新它们。 您唯一需要做的就是更改管道模板的名称,使其与要部署到的环境的名称相匹配。 在本文描述的场景中,新模板被命名为 build-deploy-acceptance-SampleSolution.yml,因为我们在部署到新的验收环境。

下表介绍管道模板中的占位符。

占位符 说明 示例
RepositoryContainingTheBuildTemplates 包含管道模板的 Azure DevOps Git 存储库的名称 coe-alm-accelerator-templates
BranchContainingTheBuildTemplates 包含管道模板的 Azure DevOps Git 存储库中的分支 main
SampleSolutionName 您的解决方案的名称 我的新解决方案
alm-accelerator-variable-group Azure DevOps 项目中生成模板用于部署管道的全局变量组。 alm-accelerator-variable-group

为新的验收环境自定义管道模板

在此场景中,您需要使用管道模板将解决方案部署到您的验收环境。 验收环境不是为其提供管道模板的三个默认环境的其中一个。 您需要单独创建。

复制其中一个默认模板,例如,build-deploy-test-SampleSolution.yml,使用基于要部署到的环境的新名称将其提交到模板存储库。 在此示例中,将其命名为 build-deploy-acceptance-SampleSolution.yml

更新部署配置文件以包括验收环境

在 ALM 加速器中,部署配置文件包含为解决方案创建部署管道所需的信息。 解决方案的部署配置文件存储在 ALM 加速器解决方案表中。 将解决方案与配置文件关联并导出时,ALM 加速器导出管道会根据部署配置文件中的信息为解决方案生成部署管道。 部署配置文件可以随时更新。

先决条件

在 ALM Accelerator 应用程序中为解决方案 创建配置文件。

添加新部署步骤和更新管道模板名称

  1. 打开 ALM 加速器应用。

  2. 选择部署配置文件选项卡,然后打开要更新的解决方案的配置文件。

  3. 部署步骤下,选择新建部署步骤

  4. 将新部署步骤命名为验收

  5. 步骤编号设置为 2

  6. 为您的部署步骤创建部署环境,将其命名为验收

  7. 将 URL 设置为您的验收环境的 URL;例如,https://myacceptanceenvironment.crm.dynamics.com/

  8. 生成模板路径设置为您创建的管道模板的路径;例如,Pipelines/build-deploy-acceptance-SampleSolution.yml

  9. 可部署设置为允许,将审批类型设置为拉取请求,将目标分支设置为[使用解决方案分支]

    这些设置与测试环境的默认值相同。 您可以通过查看测试部署步骤来找到此步骤的默认值。

验证新部署步骤和管道模板

要验证新的部署步骤和管道模板,再次导出解决方案。 ALM 加速器将基于新的部署步骤和管道模板为解决方案创建部署管道。

要验证新的部署管道,运行一个版本并将其部署到验收环境。

现在,您的解决方案应该有四个部署管道:三个用于默认环境,一个用于验收环境。

后续步骤