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
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 un 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 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.
Si vous ne spécifiez aucun déclencheur push, envoie une build à n’importe quelle branche.
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
, tags
ou paths
, cela équivaut à spécifier *
dans la include
clause .
Important
Lorsque vous spécifiez un déclencheur, seules les branches que vous configurez explicitement pour l’inclusion déclenchent 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 aucune inclusion, rien ne se déclenche.
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
batch
booléen.
Indique s’il faut traiter par lot les modifications par branche.
branches
includeExcludeFilters.
Noms de branche à inclure ou à exclure pour déclencher une exécution.
paths
includeExcludeFilters.
Chemins de 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 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.
Propriétés
batch
booléen.
Indique s’il faut traiter par lot les modifications par branche.
branches
includeExcludeFilters.
Noms de branche à inclure ou à exclure pour déclencher une exécution.
paths
includeExcludeFilters.
Chemins de fichiers à 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.