pr definition

Un desencadenador de solicitud de incorporación de cambios especifica qué ramas hacen que se ejecute una compilación de solicitud de incorporación de cambios.

Definiciones que hacen referencia a esta definición: de canalización

Implementaciones

Implementación	Descripción
pr: ninguno	Deshabilite los desencadenadores de solicitud de incorporación de cambios.
pr: de lista de cadenas	Lista de ramas que desencadenan una ejecución.
pr: autoCancel, ramas, rutas de acceso, borradores	Sintaxis completa para el control completo.

Observaciones

Si no especifica ningún desencadenador de solicitud de incorporación de cambios, las solicitudes de incorporación de cambios a cualquier bifurcación desencadenan una compilación.

Hay tres opciones de sintaxis distintas para la palabra clave pr: una lista de ramas que se van a incluir, una manera de deshabilitar los desencadenadores de pr y la sintaxis completa para el control completo.

Importante

Los desencadenadores de PR de YAML solo se admiten en GitHub y Bitbucket Cloud. Si usa Git de Azure Repos, puede configurar una directiva de rama de para la validación de compilación para desencadenar la canalización de compilación para la validación.

Si especifica una cláusula exclude sin una cláusula include para branches o paths, equivale a especificar * en la cláusula include.

pr: none

Deshabilite los desencadenadores de solicitud de incorporación de cambios.

pr: none # Disable pull request triggers.

pr cadena. Valores permitidos: ninguno.

Deshabilite los desencadenadores de solicitud de incorporación de cambios.

Ejemplos

Sintaxis de deshabilitación:

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

pr: lista de cadenas

Lista de ramas que desencadenan una ejecución.

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

Tipos de lista

Tipo	Descripción
cuerda / cadena	Lista de ramas que desencadenan una ejecución.

Observaciones

La sintaxis de lista especifica una lista de ramas que desencadenan una ejecución cuando se genera una solicitud de incorporación de cambios o se realiza una inserción en la rama de origen de una solicitud de incorporación de cambios generada.

Ejemplos

Sintaxis de lista:

pr:
- main
- develop

pr: autoCancel, ramas, rutas de acceso, borradores

Use la sintaxis completa cuando necesite control total del desencadenador de solicitud de incorporación de cambios.

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.

Propiedades

autoCancel booleano .
si se cancelan las compilaciones de pr en ejecución cuando una nueva confirmación llega a la rama. Valor predeterminado: true.

branches includeExcludeFilters.
nombres de rama que se van a incluir o excluir para desencadenar una ejecución.

paths includeExcludeFilters.
rutas de acceso de archivo para incluir o excluir para desencadenar una ejecución.

drafts booleano .
si se inicia una ejecución cuando se crea una solicitud de incorporación de cambios de borrador. Valor predeterminado: true.

Ejemplos

Sintaxis completa:

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

Consulte también

Obtenga más información sobre desencadenadores de solicitud de incorporación de cambios y cómo especificarlos.