definição de pr

Um gatilho de solicitação de pull especifica quais branches fazem com que um build de solicitação de pull seja executado.

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

Implementações

Implementação	Descrição
pr: nenhum	Desabilitar gatilhos de solicitação de pull.
pr: de lista de cadeias de caracteres	Lista de branches que disparam uma execução.
pr: autoCancel, branches, caminhos, rascunhos	Sintaxe completa para controle completo.

Observações

Se você não especificar nenhum gatilho de solicitação de pull, efetue pull de solicitações para qualquer branch disparar um build.

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

Importante

Os gatilhos de PR YAML têm suporte apenas no GitHub e no Bitbucket Cloud. Se você usar o Git do Azure Repos, poderá configurar uma política de branch para validação de build para disparar o pipeline de build para validação.

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

pr: nenhum

Desabilitar gatilhos de solicitação de pull.

pr: none # Disable pull request triggers.

pr cadeia de caracteres. Valores permitidos: nenhum.

Desabilitar gatilhos de solicitação de pull.

Exemplos

Sintaxe de desabilitação:

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

pr: lista de cadeias de caracteres

Lista de branches que disparam uma execução.

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

Tipos de lista

Tipo	Descrição
corda	Lista de branches que disparam uma execução.

Observações

A sintaxe de lista especifica uma lista de branches que disparam uma execução quando uma solicitação de pull é gerada ou um push é feito para o branch de origem de uma solicitação de pull gerada.

Exemplos

Sintaxe de lista:

pr:
- main
- develop

pr: autoCancel, branches, caminhos, rascunhos

Use a sintaxe completa quando precisar de controle total do gatilho de solicitação de 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 booliano.
Se deve cancelar a execução de builds de PR quando uma nova confirmação chegar no branch. Padrão: true.

branches includeExcludeFilters.
nomes de branch a serem incluídos ou excluídos para disparar uma execução.

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

drafts booliano.
Se deve iniciar uma execução quando um rascunho de PR é criado. Padrão: true.

Exemplos

Sintaxe completa:

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

Consulte também

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