pr definição

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

Propriedades que usam essa definição: pipeline.pr

Propriedades que usam essa definição: pipeline.pr

Propriedades que usam essa definição: pipeline.pr

Propriedades que usam essa definição: pipeline.pr

Propriedades que usam essa definição: pipeline.pr

Propriedades que usam essa definição: pipeline.pr

Sobrecargas

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

Comentários

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

Há três opções de sintaxe distintas para a pr palavra-chave: uma lista de branches a serem incluídas, 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 Azure Repos Git, poderá configurar uma política de branch para validação de build para disparar o pipeline de build para validação.

Importante

Os gatilhos DE PR YAML têm suporte apenas no GitHub. Se você usar Azure Repos Git, 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 exclude cláusula sem uma include cláusula para branches ou paths, será equivalente a especificar * na include cláusula.

Importante

Quando você especifica um gatilho de solicitação de pull, apenas ramificações que você configura explicitamente para inclusão disparam um pipeline. As inclusões são processadas primeiro e, em seguida, as exclusões são removidas dessa lista. Se você especificar uma exclusão, mas sem inclusões, nada disparará.

pr: nenhum

Desabilitar gatilhos de solicitação de pull.

pr: none # Disable pull request triggers.

Propriedades

pr

string

Desabilitar gatilhos de solicitação de pull. Valores aceitáveis: nenhum

pr: none # Disable pull request triggers.

Propriedades

pr

string

Desabilitar gatilhos de solicitação de pull. Valores aceitáveis: nenhum

pr: none # Disable pull request triggers.

Propriedades

pr

string

Desabilitar gatilhos de solicitação de pull. Valores aceitáveis: nenhum

pr: none # Disable pull request triggers.

Propriedades

pr

string

Desabilitar gatilhos de solicitação de pull. Valores aceitáveis: nenhum

pr: none # Disable pull request triggers.

Propriedades

pr

string

Desabilitar gatilhos de solicitação de pull. Valores aceitáveis: nenhum

pr: none # Disable pull request triggers.

Propriedades

pr

string

Desabilitar gatilhos de solicitação de pull. Valores aceitáveis: nenhum

Exemplos

Sintaxe de desabilitação:

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

pr: lista branchFilter

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 levantada.

pr: [ branchFilter ] # List of branches that trigger a run. [^\/~\^\: \[\]\\]+(\/[^\/~\^\: \[\]\\]+)*

Propriedades

pr

string

Desabilitar gatilhos de solicitação de pull. Valores aceitáveis: [^\/~\^\: \[\]\\]+(\/[^\/~\\^\: \[\]\\]+)*

pr: [ branchFilter ] # List of branches that trigger a run. [^\/~\^\: \[\]\\]+(\/[^\/~\^\: \[\]\\]+)*

Propriedades

pr

string

Desabilitar gatilhos de solicitação de pull. Valores aceitáveis: [^\/~\^\: \[\]\\]+(\/[^\/~\\^\: \[\]\\]+)*

pr: [ branchFilter ] # List of branches that trigger a run. [^\/~\^\: \[\]\\]+(\/[^\/~\^\: \[\]\\]+)*

Propriedades

pr

string

Desabilitar gatilhos de solicitação de pull. Valores aceitáveis: [^\/~\^\: \[\]\\]+(\/[^\/~\\^\: \[\]\\]+)*

pr: [ branchFilter ] # List of branches that trigger a run. [^\/~\^\: \[\]\\]+(\/[^\/~\^\: \[\]\\]+)*

Propriedades

pr

string

Desabilitar gatilhos de solicitação de pull. Valores aceitáveis: [^\/~\^\: \[\]\\]+(\/[^\/~\\^\: \[\]\\]+)*

pr: [ branchFilter ] # List of branches that trigger a run. [^\/~\^\: \[\]\\]+(\/[^\/~\^\: \[\]\\]+)*

Propriedades

pr

string

Desabilitar gatilhos de solicitação de pull. Valores aceitáveis: [^\/~\^\: \[\]\\]+(\/[^\/~\\^\: \[\]\\]+)*

pr: [ branchFilter ] # List of branches that trigger a run. [^\/~\^\: \[\]\\]+(\/[^\/~\^\: \[\]\\]+)*

Propriedades

pr

string

Desabilitar gatilhos de solicitação de pull. Valores aceitáveis: [^\/~\^\: \[\]\\]+(\/[^\/~\\^\: \[\]\\]+)*

Exemplos

Sintaxe de lista:

pr:
- main
- develop

pr: branches, paths

Sintaxe completa para controle completo.

pr:
  branches:  # Branch names to include or exclude for triggering a run.
    include: [ branchFilter ] # List of items to include. 
    exclude: [ branchFilter ] # List of items to exclude. 
  paths:  # File paths to include or exclude for triggering a run.
    include: [ branchFilter ] # List of items to include. 
    exclude: [ branchFilter ] # List of items to exclude. 

Propriedades

branches

lista de cadeias de caracteres include/exclude

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

paths

lista de cadeias de caracteres include/exclude

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

pr: autoCancel, branches, paths

Sintaxe completa para controle completo.

pr:
  autoCancel: boolean # Whether to cancel running PR builds when a new commit lands in the branch. Default: true.  (false,n,no,off,on,true,y,yes)
  branches:  # Branch names to include or exclude for triggering a run.
    include: [ branchFilter ] # List of items to include. 
    exclude: [ branchFilter ] # List of items to exclude. 
  paths:  # File paths to include or exclude for triggering a run.
    include: [ branchFilter ] # List of items to include. 
    exclude: [ branchFilter ] # List of items to exclude. 

Propriedades

autoCancel

booleano

Se é necessário cancelar a execução de builds de PR quando uma nova confirmação cair no branch. Padrão: true.

branches

lista de cadeias de caracteres include/exclude

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

paths

lista de cadeias de caracteres include/exclude

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

pr:
  autoCancel: boolean # Whether to cancel running PR builds when a new commit lands in the branch. Default: true.  (false,n,no,off,on,true,y,yes)
  branches:  # Branch names to include or exclude for triggering a run.
    include: [ branchFilter ] # List of items to include. 
    exclude: [ branchFilter ] # List of items to exclude. 
  paths:  # File paths to include or exclude for triggering a run.
    include: [ branchFilter ] # List of items to include. 
    exclude: [ branchFilter ] # List of items to exclude. 

Propriedades

autoCancel

booleano

Se é necessário cancelar a execução de builds de PR quando uma nova confirmação cair no branch. Padrão: true.

branches

lista de cadeias de caracteres include/exclude

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

paths

lista de cadeias de caracteres include/exclude

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

pr:
  autoCancel: boolean # Whether to cancel running PR builds when a new commit lands in the branch. Default: true.  (false,n,no,off,on,true,y,yes)
  branches:  # Branch names to include or exclude for triggering a run.
    include: [ branchFilter ] # List of items to include. 
    exclude: [ branchFilter ] # List of items to exclude. 
  paths:  # File paths to include or exclude for triggering a run.
    include: [ branchFilter ] # List of items to include. 
    exclude: [ branchFilter ] # List of items to exclude. 

Propriedades

autoCancel

booleano

Se é necessário cancelar a execução de builds de PR quando uma nova confirmação cair no branch. Padrão: true.

branches

lista de cadeias de caracteres include/exclude

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

paths

lista de cadeias de caracteres include/exclude

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

pr:
  autoCancel: boolean # Whether to cancel running PR builds when a new commit lands in the branch. Default: true.  (false,n,no,off,on,true,y,yes)
  branches:  # Branch names to include or exclude for triggering a run.
    include: [ branchFilter ] # List of items to include. 
    exclude: [ branchFilter ] # List of items to exclude. 
  paths:  # File paths to include or exclude for triggering a run.
    include: [ branchFilter ] # List of items to include. 
    exclude: [ branchFilter ] # List of items to exclude. 

Propriedades

autoCancel

booleano

Se é necessário cancelar a execução de builds de PR quando uma nova confirmação cair no branch. Padrão: true.

branches

lista de cadeias de caracteres include/exclude

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

paths

lista de cadeias de caracteres include/exclude

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

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.  (false,n,no,off,on,true,y,yes)
  branches:  # Branch names to include or exclude for triggering a run.
    include: [ branchFilter ] # List of items to include. 
    exclude: [ branchFilter ] # List of items to exclude. 
  paths:  # File paths to include or exclude for triggering a run.
    include: [ branchFilter ] # List of items to include. 
    exclude: [ branchFilter ] # List of items to exclude. 
  drafts: boolean # Whether to start a run when a draft PR is created. Default: true.  (false,n,no,off,on,true,y,yes)

Propriedades

autoCancel

booleano

Se é necessário cancelar a execução de builds de PR quando uma nova confirmação cair no branch. Padrão: true.

branches

lista de cadeias de caracteres include/exclude

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

paths

lista de cadeias de caracteres include/exclude

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

drafts

booleano

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

Confira também

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