definição pr

Um acionador de pedido Pull especifica quais os ramos que fazem com que uma compilação de pedido Pull seja executada.

Definições que referenciam esta definição: pipeline

Implementações

Implementação	Descrição
pr: nenhum	Desative os acionadores de pedidos Pull.
pr: lista de cadeias	Lista de ramos que acionam uma execução.
pr: autoCancel, ramos, caminhos, rascunhos	Sintaxe completa para controlo total.

Observações

Se não especificar nenhum acionador de pedido Pull, os pedidos Pull para qualquer ramo acionam uma compilação.

Existem três opções de sintaxe distintas para a pr palavra-chave: uma lista de ramos a incluir, uma forma de desativar os acionadores pr e a sintaxe completa para um controlo completo.

Importante

Os acionadores de PR YAML são suportados apenas no GitHub e no Bitbucket Cloud. Se utilizar o Git de Repositórios do Azure, pode configurar uma política de ramo para validação de compilação para acionar o pipeline de compilação para validação.

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

pr: nenhum

Desative os acionadores de pedidos Pull.

pr: none # Disable pull request triggers.

pr cadeia. Valores permitidos: nenhum.

Desative os acionadores de pedidos Pull.

Exemplos

Sintaxe de desativação:

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

pr: lista de cadeias

Lista de ramos que acionam uma execução.

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

Tipos de lista

Tipo	Description
cadeia (de carateres)	Lista de ramos que acionam uma execução.

Observações

A sintaxe da lista especifica uma lista de ramos que acionam uma execução quando um pedido Pull é gerado ou é feito um push para o ramo de origem de um pedido Pull elevado.

Exemplos

Sintaxe da lista:

pr:
- main
- develop

pr: autoCancel, ramos, caminhos, rascunhos

Utilize a sintaxe completa quando precisar de controlo total do acionador do pedido 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

autoCancelbooleano.
Se pretende cancelar a execução de compilações de PR quando uma nova consolidação é apresentada no ramo. Predefinição: true.

branchesincludeExcludeFilters.
Nomes de ramo a incluir ou excluir para acionar uma execução.

pathsincludeExcludeFilters.
Caminhos de ficheiro a incluir ou excluir para acionar uma execução.

draftsbooleano.
Se pretende iniciar uma execução quando é criado um pr de rascunho. Predefinição: true.

Exemplos

Sintaxe completa:

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

Ver também

Saiba mais sobre os acionadores de pedidos Pull e como especificá-los.