Configurar pontos de extensão do pipeline
Os modelos de pipeline no ALM Accelerator for Power Platform têm vários pontos de extensão, ou ganchos. Você pode usá-los para personalizar os pipelines enquanto minimiza o ruído de conflitos de mesclagem ao atualizar os modelos de pipeline para uma nova versão.
Pontos de extensão nos modelos YAML do ALM Accelerator
A tabela a seguir lista os pontos de extensão suportados.
| Nome do ficheiro YAML de Pipeline | Ponto de extensão | Description | Ficheiro YAML de extensão |
|---|---|---|---|
| Modelos/export-Solution.yml | Exportar Pré-hook de Solução | Adiciona personalizações como o passo inicial no pipeline de solução de exportação. | Hooks/export-solution-pre-hook.yml |
| Modelos/export-Solution.yml | Pré-hook de Descompactar Solução | Adiciona personalizações antes do processo de descompactação da solução. | Hooks/export-solution-unpack-pre-hook.yml |
| Modelos/export-Solution.yml | Manipular Pré-hook | Adiciona personalizações antes da manipulação de arquivos de solução. | Hooks/export-solution-manipulate-pre-hook.yml |
| Modelos/export-Solution.yml | Atualizar Pré-hook de definições de implementação | Adiciona personalizações antes de atualizar as configurações de implantação. | Hooks/export-solution-update-deploymentsettings-pre-hook.yml |
| Modelos/export-Solution.yml | Pré-hook de Consolidação de Solução | Adiciona personalizações antes que o código-fonte da solução seja confirmado no Git. | Hooks/export-solution-commit-pre-hook.yml |
| Modelos/export-Solution.yml | Exportar Pós-hook de Solução | Adiciona personalizações como o passo final no pipeline de solução de exportação. | Hooks/export-solution-post-hook.yml |
| Modelos/build-Solution.yml | Pré-hook de Solução de Compilação | Adiciona personalizações como o passo inicial no pipeline de solução de compilação. | Hooks/build-solution-pre-hook.yml |
| Modelos/build-Solution.yml | Manipular Pré-hook | Adiciona personalizações antes da manipulação de arquivos de solução. | Hooks/build-solution-manipulate-pre-hook.yml |
| Modelos/build-Solution.yml | Pré-hook de Pacote Solução | Adiciona personalizações antes que a solução seja compactada a partir do código-fonte. | Hooks/build-solution-pack-pre-hook.yml |
| Modelos/build-Solution.yml | Pós-hook de Solução de Compilação | Adiciona personalizações como o passo final no pipeline de solução de compilação. | Hooks/build-solution-post-hook.yml |
| Modelos/deploy-Solution.yml | Implementar Pré-hook de Solução | Adiciona personalizações como o passo inicial no pipeline de solução de implantação. | Hooks/deploy-solution-pre-hook.yml |
| Modelos/deploy-Solution.yml | Importar Pré-hook de Solução | Adiciona personalizações antes que a solução seja importada. | Hooks/deploy-solution-import-pre-hook.yml |
| Modelos/deploy-Solution.yml | Configurar Pré-hook de Solução | Adiciona personalizações antes da configuração da solução implantada. | Hooks/deploy-solution-configure-pre-hook.yml |
| Modelos/deploy-Solution.yml | Implementar Pós-hook de Solução | Adiciona personalizações como o passo final no pipeline de solução de compilação. | Hooks/deploy-solution-post-hook.yml |
Usar pontos de extensão nos modelos YAML
Para usar os pontos de extensão para estender a funcionalidade dos pipelines do ALM Accelerator, adicione sua extensão a um modelo YAML personalizado na pasta Hooks/CustomTemplates ou diretamente ao arquivo YAML para o ponto de extensão que você deseja usar.
O exemplo a seguir usa o ponto de extensão Export Solution Pre Hook para personalizar o modelo Hooks\CustomTemplates\output-environment-variables.yml no pipeline de export-solution.yml .
Adicione o seguinte código ao arquivo export-solution-pre-hook.yml :
- template: CustomTemplates/output-environment-variables.yml
O export-solution-pre-hook.yml deve ter esta aparência:
steps:
- script: echo Export Solution Pre Hook
displayName: 'Export Solution Pre Hook'
enabled: false
- template: CustomTemplates/output-environment-variables.yml
Lidar com conflitos de mesclagem ao atualizar modelos de pipeline personalizados
Nota
Para ajudá-lo a resolver conflitos de mesclagem ao atualizar para uma nova versão dos modelos de pipeline do ALM Accelerator, recomendamos a extensão Pull Request Merge Conflict para Azure DevOps.
Se você fizer personalizações nos modelos de pipeline do ALM Accelerator, terá conflitos de mesclagem ao atualizar os modelos para uma nova versão.
Os pontos de extensão são implementados de uma forma que deve simplificar o tratamento de conflitos de mesclagem se você os tiver usado para personalizar os pipelines. Mantenha a versão alterada de um arquivo na pasta Ganchos . Ao atualizar para uma nova versão dos modelos de pipeline do ALM Accelerator, aceite todas as adições à pasta.