配置管道扩展点
中的 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 加速器管道模板时,请接受对文件夹的任何添加。