Compartir vía

definición del desencadenador

  • Artículo

Un desencadenador de inserción especifica qué ramas hacen que se ejecute una compilación de integración continua.

Definiciones que hacen referencia a esta definición: canalización, resources.repository.repository

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

Implementaciones

Implementación Descripción
trigger: none Deshabilite los desencadenadores de CI.
trigger: string list Lista de ramas que desencadenan una ejecución.
trigger: lote, ramas, rutas de acceso, etiquetas Sintaxis completa para el control completo.
Implementación Descripción
trigger: none Deshabilite los desencadenadores de CI.
trigger: string list Lista de ramas que desencadenan una ejecución.
trigger: batch, branches, paths Sintaxis completa para el control completo.

Comentarios

Para obtener más información sobre el uso de desencadenadores con un tipo de repositorio específico, consulte Repositorios de origen admitidos.

Si no especifica ningún desencadenador de inserción, las inserciones en cualquier desencadenador de rama activan una compilación.

Las canalizaciones YAML se configuran de forma predeterminada con un desencadenador de CI en todas las ramas, a menos que la opción Deshabilitar desencadenador de CI de YAML implícito esté habilitada. La opción Deshabilitar desencadenador de CI de YAML implícito se puede configurar en el nivel de organización o en el nivel de proyecto. Cuando la opción Deshabilitar desencadenador de CI de YAML implícito está habilitada, los desencadenadores de CI para canalizaciones YAML no están habilitados si la canalización yaML no tiene una trigger sección. El valor predeterminado de Disable implicit YAML CI trigger is false.

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

Especificar una cláusula exclude sin una cláusula include para branches, tags o paths, es equivalente a especificar * en la cláusula include.

Importante

Cuando se especifica un desencadenador, solo las ramas que se configuran explícitamente para la inclusión desencadenan una canalización. Las inclusiones se procesan primero y, a continuación, se quitan las exclusiones de esa lista. Si especifica una exclusión pero ninguna inclusión, no se desencadena nada.

trigger: none

Deshabilite los desencadenadores de CI.

trigger: none # Disable CI triggers.

trigger Cadena. Valores permitidos: ninguno.

Deshabilite los desencadenadores de CI.

Ejemplos

trigger: none # will disable CI builds entirely

trigger: string list

Lista de ramas que desencadenan una ejecución.

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

Tipos de lista

Tipo Descripción
string Lista de ramas que desencadenan una ejecución.

Ejemplos

trigger:
- main
- develop

trigger: lote, ramas, rutas de acceso, etiquetas

Use el control de sintaxis completa para el control total sobre el desencadenador de CI.

trigger:
  batch: boolean # Whether to batch changes per branch.
  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.
  tags: # Tag names to include or exclude for triggering a run.
    include: [ string ] # List of items to include.
    exclude: [ string ] # List of items to exclude.

Propiedades

batchbooleano.
Si se van a procesar por lotes los cambios por rama.

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.

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

trigger: batch, branches, paths

Use el control de sintaxis completa para el control total sobre el desencadenador de CI.

trigger:
  batch: boolean # Whether to batch changes per branch.
  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.

Propiedades

batchbooleano.
Si se van a procesar por lotes los cambios por rama.

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.

Comentarios

Si hay muchos miembros del equipo que cargan cambios a menudo, es posible que desee reducir el número de ejecuciones que inicie. Si establece batch en true, cuando se ejecuta una canalización el sistema espera hasta que se completa la ejecución y entonces inicia otra ejecución con todos los cambios que aún no se han compilado. De manera predeterminada, batch es false.

Importante

batch no se admite en desencadenadores de recursos de repositorio .

Para obtener más información, consulte Desencadenadores: desencadenadores de CI y elija el tipo de repositorio.

# specific branch build with batching
trigger:
  batch: true
  branches:
    include:
    - main

Ejemplos

trigger:
  batch: true
  branches:
    include:
    - features/*
    exclude:
    - features/experimental/*
  paths:
    exclude:
    - README.md

Vea también

Obtenga más información sobre los desencadenadores y cómo especificarlos.