配置管道扩展点

中的 ALM Accelerator for Power Platform 管道模板具有多个扩展点或 钩子。 您可以使用它们来自定义管道,同时在将管道模板升级到新版本时最大限度地减少合并冲突的干扰。

ALM 加速器 YAML 模板中的扩展点

下表列出了支持的扩展点。

管道 YAML 文件名 扩展点 Description 扩展 YAML 文件
Templates/export-Solution.yml 导出解决方案 Pre Hook 将自定义项添加为导出解决方案管道中的初始步骤。 Hooks/export-solution-pre-hook.yml
Templates/export-Solution.yml 解决方案解包 Pre Hook 在解包解决方案过程之前添加自定义项。 Hooks/export-solution-unpack-pre-hook.yml
Templates/export-Solution.yml 操作 Pre Hook 在处理解决方案文件之前添加自定义项。 Hooks/export-solution-manipulate-pre-hook.yml
Templates/export-Solution.yml 更新部署设置 Pre Hook 在更新部署设置之前添加自定义项。 Hooks/export-solution-update-deploymentsettings-pre-hook.yml
Templates/export-Solution.yml 解决方案提交 Pre Hook 在将解决方案源代码提交到 Git 之前添加自定义项。 Hooks/export-solution-commit-pre-hook.yml
Templates/export-Solution.yml 导出解决方案 Post Hook 将自定义项添加为导出解决方案管道中的最后步骤。 Hooks/export-solution-post-hook.yml
Templates/build-Solution.yml 构建解决方案 Pre Hook 将自定义项添加为生成解决方案管道中的初始步骤。 Hooks/build-solution-pre-hook.yml
Templates/build-Solution.yml 操作 Pre Hook 在处理解决方案文件之前添加自定义项。 Hooks/build-solution-manipulate-pre-hook.yml
Templates/build-Solution.yml 解决方案打包 Pre Hook 在从源代码打包解决方案之前添加自定义项。 Hooks/build-solution-pack-pre-hook.yml
Templates/build-Solution.yml 构建解决方案 Post Hook 将自定义项添加为生成解决方案管道中的最后步骤。 Hooks/build-solution-post-hook.yml
Templates/deploy-Solution.yml 部署解决方案 Pre Hook 将自定义项添加为部署解决方案管道中的初始步骤。 Hooks/deploy-solution-pre-hook.yml
Templates/deploy-Solution.yml 导入解决方案 Pre Hook 在导入解决方案之前添加自定义项。 Hooks/deploy-solution-import-pre-hook.yml
Templates/deploy-Solution.yml 配置解决方案 Pre Hook 在配置已部署的解决方案之前添加自定义项。 Hooks/deploy-solution-configure-pre-hook.yml
Templates/deploy-Solution.yml 部署解决方案 Post Hook 将自定义项添加为生成解决方案管道中的最后步骤。 Hooks/deploy-solution-post-hook.yml

在 YAML 模板中使用扩展点

要使用扩展点扩展 ALM 加速器管道的功能,请将扩展添加到 Hooks/CustomTemplates 文件夹中的自定义 YAML 模板 ,或直接添加到要使用的扩展指向的 YAML 文件。

以下示例使用 Export Solution Pre Hook 扩展指向自定义 export-solution.yml 管道中的 模板 Hooks\CustomTemplates\output-environment-variables.yml

将以下代码添加到 export-solution-pre-hook.yml 文件中:

- template: CustomTemplates/output-environment-variables.yml

export-solution-pre-hook.yml 应如下所示:

steps:
- script: echo Export Solution Pre Hook
  displayName: 'Export Solution Pre Hook'
  enabled: false

- template: CustomTemplates/output-environment-variables.yml

在升级自定义管道模板时处理合并冲突

备注

为了帮助您在升级到 ALM 加速器管道模板的新版本时解决合并冲突,我们建议使用 Pull Request Merge Conflict 扩展 Azure DevOps。

如果您对 ALM 加速器管道模板进行了任何自定义,则在将模板升级到新版本时将出现合并冲突。

扩展点的实现方式是,如果您已使用它们来自定义管道,则应该可以简化处理合并冲突。 将更改后的文件 版本保存在 Hooks 文件夹中。 升级到新版本的 ALM 加速器管道模板时,请接受对文件夹的任何添加。

后续步骤