Especificar eventos que acionam pipelines

Serviços de DevOps do Azure | Azure DevOps Server | Azure DevOps Server 2022

Um acionador de pipeline diz a um pipeline quando deve ser executado. Pode configurar um gatilho para executar um pipeline com base num calendário ou em resposta a um evento, como a criação de um pull request. O Azure Pipelines suporta os seguintes tipos de triggers:

  • Os acionadores de integração contínua (acionadores de CI) executam um pipeline quando envias código para uma ramificação.
  • Os gatilhos de pull request (gatilhos de PR) executam um pipeline quando cria um PR ou envia código para o ramo de origem de um PR aberto. Os repositórios do GitHub suportam gatilhos de comentário que executam um pipeline quando adicionas comentários numa pull request aberta.
  • Os acionadores agendados executam um pipeline de acordo com uma programação predefinida.
  • Os gatilhos de completação de pipeline executam um pipeline quando outro pipeline termina.

Este artigo fornece uma visão geral dos gatilhos de pipeline YAML e dos gatilhos clássicos de pipeline de build . Os pipelines de lançamento clássicos têm versões semelhantes às dos acionadores descritos na lista anterior. Para mais informações, consulte Acionadores do pipeline clássico de lançamento.

Desencadeadores de IC

Os acionadores de CI disparam um pipeline quando é efetuado um push para uma ramificação que cumpre os critérios definidos pelo acionador. Utilize a palavra-chave trigger para configurar um acionador de CI. Por exemplo, para executar um pipeline quando é efetuado um push para o ramo main, especifique o seguinte gatilho.

trigger:
- main

Se não configurares explicitamente o teu pipeline, todas as ramificações têm os disparadores de CI ativados por defeito, a menos que Desativar acionador de CI implícito esteja definido ou as definições da IU substituam o acionador YAML.

Se não configurares explicitamente o teu pipeline, todas as ramificações têm os acionadores de IC ativados por predefinição, a menos que esteja definida a opção Disable implied CI trigger ou que as definições da interface de utilizador substituam o acionador YAML.

Nota

Desativar o gatilho de CI implícito está disponível apenas no Azure DevOps Server, versão 2022.2 e posteriores. No Azure DevOps Server 2022 e 2022.1, os gatilhos CI estão ativados por defeito se não estiverem explicitamente configurados.

Para desativar os acionadores de CI no seu pipeline, use a sintaxe seguinte.

trigger: none

Os pipelines YAML suportam gatilhos CI para os seguintes tipos de repositório. Para obter informações específicas sobre como utilizar acionadores de CI com um tipo de repositório específico, consulte os artigos seguintes.

Para informações sobre a sintaxe completa dos gatilhos YAML e as opções disponíveis para gatilhos CI, veja definição de gatilho.

Importante

Os caminhos no Git são sensíveis a maiúsculas e minúsculas, incluindo os filtros de caminho de acionamento de CI e PR.

Acionadores de PR

Os gatilhos de pull request (PR) fazem com que um pipeline seja executado sempre que se abre um pull request, ou quando se enviam alterações para o ramo de origem de um pull request. Use a pr palavra-chave para configurar um gatilho de PR. Por exemplo, para executar um pipeline quando um PR for elevado para o main branch, especifique o seguinte gatilho.

pr:
- main

Se não configurares explicitamente os triggers PR no teu pipeline, eles estão ativados por defeito, a menos que as definições da interface sobreponham o trigger YAML. Pull requests para qualquer ramificação acionam a execução de um pipeline. Para desativar os acionadores de PR no seu pipeline, use a seguinte sintaxe.

pr: none

Os gatilhos PR YAML são suportados para GitHub e Bitbucket Cloud. Para mais informações sobre a utilização de gatilhos de PR com estes tipos de repositórios, consulte Gatilhos de PR no GitHub e Gatilhos de PR no Bitbucket Cloud. Para obter informações sobre a sintaxe completa do acionador de PR em YAML, veja definição de PR.

O Repositórios do Azure Git utiliza políticas de ramificação para implementar accionadores de PR. Para mais informações, veja PR triggers em Repositórios do Azure Git.

Acionadores de comentários

Os acionadores por comentário configuram um pipeline para ser executado quando os colaboradores fazem um comentário num pedido de pull que contém um comando de pedido de pull, como /azp run. Os gatilhos de comentário são suportados apenas para repositórios do GitHub. Para mais informações, consulte acionadores de comentários no repositório do GitHub.

Acionadores agendados

Os acionadores agendados executam um pipeline de acordo com um agendamento predefinido. Todos os tipos de repositórios que suportam pipelines YAML suportam gatilhos programados nos pipelines YAML. Estes tipos de repositórios incluem Repositórios do Azure Git, GitHub, GitHub Enterprise Server e Bitbucket Cloud.

Para definir um acionador programado em YAML, utilize a palavra-chave schedules e defina o agendamento utilizando a sintaxe cron. O exemplo seguinte configura um horário que corre todos os dias à meia-noite.

# YAML file in the main branch
schedules:
- cron: '0 0 * * *'
  displayName: Daily midnight build
  branches:
    include:
    - main

Para mais informações e exemplos, consulte Acionadores agendados, definição de agendamentos e definição de schedules.cron.

Acionadores de conclusão do pipeline

Os acionadores de pipeline em pipelines YAML e os acionadores de conclusão de compilação em pipelines de compilação clássicos permitem acionar um pipeline após a conclusão de outro.

Configura um trigger de recurso de pipeline no teu pipeline para iniciar uma execução de pipeline quando o pipeline de origem terminar uma execução.

resources:
  pipelines:
  - pipeline: sourcePipelineResource # Label for this pipeline resource; used when referring to it elsewhere in the pipeline.
    source: source-pipeline # The name of the pipeline referenced by this pipeline resource.
    project: FabrikamProject # Required only if the source pipeline is in another project
    trigger: true # Run this pipeline when any run of source-pipeline completes

Pode adicionar vários recursos de pipeline no seu pipeline. Pode configurar o acionador para ser executado quando qualquer versão do pipeline de origem for concluída, ou limitá-lo a determinadas ramificações.

Para mais informações e exemplos, consulte Acionadores de conclusão de pipeline.

Para a sintaxe completa e as opções de acionamento, consulte a definição de resources.pipelines.pipeline.

Consideração de ramificação para gatilhos em pipelines YAML

Os pipelines YAML podem ter diferentes versões do pipeline em ramificações diferentes, o que pode afetar qual versão dos gatilhos do pipeline é avaliada e qual versão do pipeline deve ser executada.

Tipo de acionador Versão do Pipeline YAML
Acionadores de CI (trigger) A versão do pipeline na ramificação empurrada é usada.
Acionadores de PR (pr) A versão do pipeline na ramificação de origem para a solicitação pull é usada.
Acionadores de comentários em pull requests do GitHub A versão do pipeline na ramificação de origem para a solicitação pull é usada.
Acionadores agendados Consulte Considerações sobre ramificação para gatilhos agendados.
Acionadores de conclusão do pipeline Consulte Considerações de ramificação para gatilhos de conclusão de pipeline.

Pipelines clássicos de lançamento

Os acionadores de implementação contínua ajudam a iniciar releases clássicas quando uma compilação clássica ou um pipeline YAML é concluído.

Os gatilhos de liberação agendada permitem executar um pipeline de liberação de acordo com um cronograma.

Os acionadores de release de pull request são utilizados para implementar diretamente um pull request com releases clássicas.

Os gatilhos de estágio na versão clássica são usados para configurar como cada estágio em uma versão clássica é acionado.

  • Last updated on