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: canalización

Implementaciones

Implementación	Descripción
pr: none	Deshabilite los desencadenadores de solicitud de incorporación de cambios.
pr: 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 rama 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 Azure Repos Git, puede configurar una directiva de rama para la validación de compilación para desencadenar la canalización de compilación para la validación.

Especificar una cláusula exclude sin una cláusula include para branches o paths, es equivalente 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
string	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

autoCancelbooleano.
Si se cancelan las compilaciones de solicitud de incorporación de cambios en ejecución cuando una nueva confirmación llega a la rama. Valor predeterminado: true.

branchesincludeExcludeFilters.
Nombres de rama que se van a incluir o excluir para desencadenar una ejecución.

pathsincludeExcludeFilters.
Rutas de acceso de archivo que se van a incluir o excluir para desencadenar una ejecución.

draftsbooleano.
Indica si se debe iniciar 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 los desencadenadores de solicitudes de incorporación de cambios y cómo especificarlos.