définition de déclencheur

Un déclencheur push spécifie les branches qui entraînent l’exécution d’une build d’intégration continue.

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

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 un contrôle complet.

Remarques

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

Les pipelines YAML sont configurés par défaut avec un déclencheur CI sur toutes les branches, sauf si le paramètre désactiver le déclencheur CI YAML implicite est activé. Le paramètre désactiver le déclencheur CI YAML implicite peut être configuré au niveau organization 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 trigger section. La valeur par défaut pour Désactiver le déclencheur CI YAML implicite est false.

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

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

déclencheur : aucun

Désactivez les déclencheurs CI.

trigger: none # Disable CI triggers.

trigger String. 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 liste

Type	Description
string	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 un contrôle total sur 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

batchbooléen.
Indique s’il faut traiter par lot les modifications par branche.

branchesincludeExcludeFilters.
Noms de branche à inclure ou à exclure pour déclencher une exécution.

pathsincludeExcludeFilters.
Chemins de fichiers à inclure ou à exclure pour déclencher une exécution.

tagsincludeExcludeFilters.
Noms d’étiquettes à inclure ou à exclure pour déclencher une exécution.

Remarques

Si de nombreux membres d’équipe chargent souvent des changements, vous pouvez réduire le nombre d’exécutions que vous démarrez. Si vous définissez batch sur true, quand 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 tous les changements qui n’ont pas encore été générés. Par défaut, batch est false.

Important

batch n’est pas pris en charge dans les déclencheurs de ressources de dépôt .

Pour plus d’informations, consultez Déclencheurs - Déclencheurs CI et choisissez votre type de dépôt.

# 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.