Compartir a través de

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

Implementaciones

Implementación Descripción
desencadenador de : ninguno Deshabilite los desencadenadores de CI.
desencadenador de : de lista de cadenas Lista de ramas que desencadenan una ejecución.
desencadenador: lote, ramas, rutas de acceso, etiquetas Sintaxis completa para el control completo.
Implementación Descripción
desencadenador de : ninguno Deshabilite los desencadenadores de CI.
desencadenador de : de lista de cadenas Lista de ramas que desencadenan una ejecución.
desencadenador de : lote, ramas, rutas de acceso Sintaxis completa para el control completo.

Observaciones

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, se inserta en cualquier desencadenador de rama una compilación.

Las canalizaciones de YAML se configuran de forma predeterminada con un desencadenador de CI en todas las ramas, a menos que la configuración del desencadenador de CI de YAML implícito esté habilitada. El deshabilitar el desencadenador de CI de YAML implícito se puede configurar en el nivel de organización o en el nivel de proyecto. Cuando el Deshabilitar el desencadenador de CI de YAML implícito está habilitado, los desencadenadores de CI para canalizaciones YAML no están habilitados si la canalización yaML no tiene una sección de trigger. El valor predeterminado de Deshabilitar desencadenador de CI de YAML implícito es 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 desencadenadores de CI y la sintaxis completa para el control completo.

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

Importante

Al especificar 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
cuerda Lista de ramas que desencadenan una ejecución.

Ejemplos

trigger:
- main
- develop

trigger: batch, bifurcaciones, 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

batch booleano .
si se van a procesar por lotes los cambios por rama.

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.

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

trigger: batch, bifurcaciones, rutas de acceso

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

batch booleano .
si se van a procesar por lotes los cambios por rama.

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.

Observaciones

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

Al especificar una rama, etiqueta o ruta de acceso, puede usar un nombre exacto o un carácter comodín. Para obtener más información, vea caracteres comodín.

Importante

batch no se admite en desencadenadores de de recursos del 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

Consulte también

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