Partilhar via


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.
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 Sintaxe completa para controlo total.
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: ramos, caminhos 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.

Importante

Os acionadores de PR YAML são suportados apenas no GitHub. 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.

Importante

Quando especifica um acionador de pedido Pull, apenas os ramos que configura explicitamente para inclusão acionam um pipeline. As inclusãos são processadas primeiro e, em seguida, as exclusões são removidas dessa lista. Se especificar uma exclusão, mas sem inclusão, nada aciona.

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.

pr: autoCancel, ramos, caminhos

Sintaxe completa para controlo total.

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

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.

pr: ramos, caminhos

Sintaxe completa para controlo total.

pr:
  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

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.

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.