Configurar pontos de extensão de pipeline (obsoleto)

Note

O Acelerador ALM foi descontinuado e nenhum recurso novo está sendo adicionado. Os problemas não são mais revisados ou resolvidos.

Se você identificar um possível problema de segurança, denuncie-o ao Microsoft Security Response Center.

Use Pipelines no Power Platform para trazer recursos de automação ALM para os serviços do Power Platform e do Dynamics 365. Os pipelines podem ser usados com source code integration ou extended para integrar com Azure DevOps, GitHub e outros provedores.

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 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 a etapa inicial do pipeline de solução de exportação. Hooks/export-solution-pre-hook.yml
Templates/export-Solution.yml Pré-execução de descompactação de 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 configurações de gancho prévio 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 Gancho Pós-Exportação de Solução Adiciona personalizações como a etapa final do pipeline de exportação de soluções. Hooks/export-solution-post-hook.yml
Templates/build-Solution.yml Pré-gancho de solução de compilação Adiciona personalizações como o passo inicial no fluxo de trabalho da construção da soluçã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. Ganchos/compilar-solução-manipular-pré-gancho.yml
Templates/build-Solution.yml Pré-gatilho do pacote de soluções 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 Gancho Pós-compilação de Solução Adiciona personalizações como a etapa final no fluxo de trabalho da solução de compilação. Hooks/build-solution-post-hook.yml
Templates/deploy-Solution.yml Pré-gancho de implantação da solução Adiciona personalizações como a etapa inicial no pipeline de implantação de solução. Hooks/deploy-solution-pre-hook.yml
Templates/deploy-Solution.yml Gancho de Pré-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 Configuração de Pré-Hook da Solução Adiciona personalizações antes da configuração da solução implantada. Hooks/deploy-solution-configure-pre-hook.yml
Templates/deploy-Solution.yml Gancho Pós-Implantação de Solução Adiciona personalizações como a etapa final no fluxo de trabalho 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 customizar o template 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

Resolver conflitos de fusão ao atualizar modelos de pipeline personalizados

Note

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.

Próximas Etapas