Partilhar via

Definição de RP

Um gatilho de solicitação pull especifica quais ramificações fazem com que uma compilação de pull request seja executada.

Definições que fazem referência a esta definição: pipeline

Implementações

Execução Descrição
PR: Nenhum Desative os gatilhos de solicitação pull.
pr: lista de cadeias de caracteres Lista de ramificações que acionam uma execução.
pr: autoCancel, ramificações, caminhos, rascunhos Sintaxe completa para controle completo.
Execução Descrição
PR: Nenhum Desative os gatilhos de solicitação pull.
pr: lista de cadeias de caracteres Lista de ramificações que acionam uma execução.
pr: autoCancel, ramificações, caminhos Sintaxe completa para controle completo.

Observações

Se você especificar nenhum gatilho de solicitação pull, as solicitações pull para qualquer ramificação acionarão uma compilação.

Há três opções de sintaxe distintas para a palavra-chave pr: uma lista de ramificações a serem incluídas, uma maneira de desabilitar gatilhos PR e a sintaxe completa para controle completo.

Importante

Os gatilhos YAML PR são suportados apenas no GitHub e Bitbucket Cloud. Se você usar o Azure Repos Git, poderá configurar uma política de ramificação para validação de compilação acionar seu pipeline de compilação para validação.

Se você especificar uma cláusula exclude sem uma cláusula include para branches ou paths, isso equivale a especificar * na cláusula include.

PR: Nenhum

Desative os gatilhos de solicitação pull.

pr: none # Disable pull request triggers.

pr string. Valores permitidos: nenhum.

Desative os gatilhos de solicitação pull.

Exemplos

Sintaxe de desativação:

pr: none # will disable PR builds (but not CI builds)

PR: Lista de cadeias de caracteres

Lista de ramificações que acionam uma execução.

pr: [ string ] # List of branches that trigger a run.

Tipos de lista

Tipo Descrição
corda Lista de ramificações que acionam uma execução.

Observações

A sintaxe da lista especifica uma lista de ramificações que acionam uma execução quando uma solicitação pull é gerada ou um push é feito para a ramificação de origem de uma solicitação pull gerada.

Exemplos

Sintaxe da lista:

pr:
- main
- develop

pr: autoCancel, ramificações, caminhos, rascunhos

Use a sintaxe completa quando precisar de controle total do gatilho de solicitação pull.

pr:
  autoCancel: boolean # Whether to cancel running PR builds when a new commit lands in the branch. Default: true.
  branches: # Branch names to include or exclude for triggering a run.
    include: [ string ] # List of items to include.
    exclude: [ string ] # List of items to exclude.
  paths: # File paths to include or exclude for triggering a run.
    include: [ string ] # List of items to include.
    exclude: [ string ] # List of items to exclude.
  drafts: boolean # Whether to start a run when a draft PR is created. Default: true.

Propriedades

autoCancel booleano.
Se as compilações de RP em execução devem ser canceladas quando uma nova confirmação aterrissar na ramificação. Padrão: verdadeiro.

branches includeExcludeFilters.
Nomes de ramificações a serem incluídos ou excluídos para acionar uma execução.

paths includeExcludeFilters.
Caminhos de arquivo a serem incluídos ou excluídos para acionar uma execução.

drafts booleano.
Se uma execução deve ser iniciada quando um rascunho de RP é criado. Padrão: verdadeiro.

pr: autoCancel, ramificações, caminhos

Sintaxe completa para controle completo.

pr:
  autoCancel: boolean # Whether to cancel running PR builds when a new commit lands in the branch. Default: true.
  branches: # Branch names to include or exclude for triggering a run.
    include: [ string ] # List of items to include.
    exclude: [ string ] # List of items to exclude.
  paths: # File paths to include or exclude for triggering a run.
    include: [ string ] # List of items to include.
    exclude: [ string ] # List of items to exclude.

Propriedades

autoCancel booleano.
Se as compilações de RP em execução devem ser canceladas quando uma nova confirmação aterrissar na ramificação. Padrão: verdadeiro.

branches includeExcludeFilters.
Nomes de ramificações a serem incluídos ou excluídos para acionar uma execução.

paths includeExcludeFilters.
Caminhos de arquivo a serem incluídos ou excluídos para acionar uma execução.

Exemplos

Sintaxe completa:

pr:
  branches:
    include:
    - features/*
    exclude:
    - features/experimental/*
  paths:
    exclude:
    - README.md

Ver também

Saiba mais sobre gatilhos de solicitação pull e como especificá-los.