Partager via

définition de déclencheur

  • Article

Un déclencheur Push spécifie les branches qui provoquent l’exécution d’une build d’intégration continue.

Définitions qui font référence à cette définition : de pipeline, resources.repository.repository

Définitions qui font référence à cette définition : pipeline

Implémentations

Implémentation Description
déclencheur : aucun Désactivez les déclencheurs CI.
déclencheur : liste de chaînes Liste des branches qui déclenchent une exécution.
déclencheur : lot, branches, chemins d’accès, balises Syntaxe complète pour le contrôle complet.
Implémentation Description
déclencheur : aucun Désactivez les déclencheurs CI.
déclencheur : liste de chaînes Liste des branches qui déclenchent une exécution.
déclencheur : lot, branches, chemins d’accès Syntaxe complète pour le contrôle complet.

Remarques

Pour plus d’informations sur l’utilisation de déclencheurs avec un type de référentiel spécifique, consultez référentiels sources pris en charge.

Si vous ne spécifiez aucun déclencheur Push, envoie (push) à n’importe quel déclencheur de branche une build.

Les pipelines YAML sont configurés par défaut avec un déclencheur CI sur toutes les branches, sauf si le Désactiver le déclencheur YAML CI implicite paramètre est activé. Le Désactiver le déclencheur YAML CI implicite paramètre peut être configuré au niveau de l’organisation ou au niveau du projet. Lorsque le paramètre Désactiver le déclencheur CI YAML implicite est activé, les déclencheurs CI pour les pipelines YAML ne sont pas activés si le pipeline YAML n’a pas de section trigger. La valeur par défaut de Désactiver le déclencheur YAML CI implicite est false.

Il existe trois options de syntaxe distinctes pour le mot clé trigger : une liste de branches à inclure, un moyen de désactiver les déclencheurs CI et la syntaxe complète pour le contrôle complet.

Si vous spécifiez une clause exclude sans clause include pour branches, tagsou paths, elle équivaut à spécifier * dans la clause include.

Important

Lorsque vous spécifiez un déclencheur, seules les branches que vous configurez explicitement pour le déclencheur d’inclusion d’un pipeline. Les inclusions sont traitées en premier, puis les exclusions sont supprimées de cette liste. Si vous spécifiez une exclusion, mais qu’aucune inclusion n’est incluse, rien ne se déclenche.

déclencheur : aucun

Désactivez les déclencheurs CI.

trigger: none # Disable CI triggers.

chaîne trigger. Valeurs autorisées : aucune.

Désactivez les déclencheurs CI.

Exemples

trigger: none # will disable CI builds entirely

déclencheur : liste de chaînes

Liste des branches qui déclenchent une exécution.

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

Types de listes

Type Description
corde Liste des branches qui déclenchent une exécution.

Exemples

trigger:
- main
- develop

déclencheur : lot, branches, chemins d’accès, balises

Utilisez le contrôle de syntaxe complet pour contrôler entièrement le déclencheur 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.

Propriétés

batch booléen .
indique s’il faut traiter les modifications par branche.

branches includeExcludeFilters.
noms de branche à inclure ou exclure pour déclencher une exécution.

paths includeExcludeFilters.
chemins d’accès aux fichiers à inclure ou exclure pour déclencher une exécution.

tags includeExcludeFilters.
noms d’étiquettes à inclure ou exclure pour déclencher une exécution.

déclencheur : lot, branches, chemins d’accès

Utilisez le contrôle de syntaxe complet pour contrôler entièrement le déclencheur 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.

Propriétés

batch booléen .
indique s’il faut traiter les modifications par branche.

branches includeExcludeFilters.
noms de branche à inclure ou exclure pour déclencher une exécution.

paths includeExcludeFilters.
chemins d’accès aux fichiers à inclure ou exclure pour déclencher une exécution.

Remarques

Si vous avez de nombreux membres de l’équipe qui chargent souvent des modifications, vous pouvez réduire le nombre d’exécutions que vous démarrez. Si vous définissez batch sur true, lorsqu’un pipeline est en cours d’exécution, le système attend que l’exécution soit terminée, puis démarre une autre exécution avec toutes les modifications qui n’ont pas encore été générées. Par défaut, batch est false.

Lorsque vous spécifiez une branche, une balise ou un chemin, vous pouvez utiliser un nom exact ou un caractère générique. Pour plus d’informations, consultez caractères génériques.

Important

n’est pas pris en charge dans les déclencheurs de ressources de référentiel .

Pour plus d’informations, consultez déclencheurs - Déclencheurs CI et choisissez votre type de référentiel.

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

Exemples

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

Voir aussi

En savoir plus sur les déclencheurs et comment les spécifier.