Configurar os 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 e, ao mesmo tempo, minimizar o ruído dos conflitos de mesclagem ao atualizar os modelos de pipeline para uma nova versão.
Pontos de extensão em modelos YAML do ALM Accelerator
A tabela a seguir lista os pontos de extensão suportados.
| Nome do arquivo do YAML do pipeline | Ponto de extensão | Description | Arquivo YAML de extensão |
|---|---|---|---|
| Templates/export-Solution.yml | Pré-gancho de solução de exportação | Adiciona personalizações como o etapa inicial no pipeline de solução de exportação. | Hooks/export-solution-pre-hook.yml |
| Templates/export-Solution.yml | Pré-gancho de descompactação da solução | Adiciona personalizações antes do processo de descompactação da solução. | Hooks/export-solution-unpack-pre-hook.yml |
| Templates/export-Solution.yml | Manipular Pré-gancho | Adiciona personalizações antes da manipulação de arquivos de solução. | Hooks/export-solution-manipulate-pre-hook.yml |
| Templates/export-Solution.yml | Atualizar Pré-gancho de configurações de implantação | Adiciona personalizações antes de atualizar as configurações de implantação. | Hooks/export-solution-update-deploymentsettings-pre-hook.yml |
| Templates/export-Solution.yml | Pré-gancho de confirmação de solução | Adiciona personalizações antes que o código-fonte da solução seja enviado ao Git. | Hooks/export-solution-commit-pre-hook.yml |
| Templates/export-Solution.yml | Pós-gancho de solução de exportação | Adiciona personalizações como o etapa final no pipeline de solução de exportação. | Hooks/export-solution-post-hook.yml |
| Templates/build-Solution.yml | Pré-gancho de solução de compilação | Adiciona personalizações como o etapa inicial no pipeline da solução de compilação. | Hooks/build-solution-pre-hook.yml |
| Templates/build-Solution.yml | Manipular Pré-gancho | Adiciona personalizações antes da manipulação de arquivos de solução. | Hooks/build-solution-manipulate-pre-hook.yml |
| Templates/build-Solution.yml | Pré-gancho de compactação da solução | Adiciona personalizações antes que a solução seja empacotada a partir do código-fonte. | Hooks/build-solution-pack-pre-hook.yml |
| Templates/build-Solution.yml | Pós-gancho de solução de compilação | Adiciona personalizações como o etapa final no pipeline da solução de compilação. | Hooks/build-solution-post-hook.yml |
| Templates/deploy-Solution.yml | Pré-gancho de solução de implantação | Adiciona personalizações como o etapa inicial no pipeline de solução de implantação. | Hooks/deploy-solution-pre-hook.yml |
| Templates/deploy-Solution.yml | Pré-gancho de solução de importação | Adiciona personalizações antes da solução ser importada. | Hooks/deploy-solution-import-pre-hook.yml |
| Templates/deploy-Solution.yml | Pré-gancho de solução de configuração | Adiciona personalizações antes da configuração da solução implantada. | Hooks/deploy-solution-configure-pre-hook.yml |
| Templates/deploy-Solution.yml | Pós-gancho de solução de implantação | Adiciona personalizações como o etapa final no pipeline da solução de compilação. | Hooks/deploy-solution-post-hook.yml |
Use 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 do ponto de extensão que 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 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 ficar assim:
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
Observação
Para ajudar você 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 alguma personalização 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 caso você os tenha usado para personalizar os pipelines. Mantenha a versão alterada de um arquivo na pasta Hooks . Ao atualizar para uma nova versão dos modelos de pipeline do ALM Accelerator, aceite quaisquer adições à pasta.