definice triggeru
Trigger nabízených oznámení určuje, které větve způsobí spuštění sestavení s kontinuální integrací.
Definice, které odkazují na tuto definici: pipeline, resources.repositories.repository
Definice, které odkazují na tuto definici: kanál
Implementace
Implementace | Popis |
---|---|
trigger: none | Zakažte triggery CI. |
trigger: seznam řetězců | Seznam větví, které aktivují spuštění |
trigger: batch, branches, paths, tags | Úplná syntaxe pro úplné řízení |
Implementace | Popis |
---|---|
trigger: none | Zakažte triggery CI. |
trigger: seznam řetězců | Seznam větví, které aktivují spuštění |
trigger: batch, branches, paths | Úplná syntaxe pro úplné řízení |
Poznámky
Další informace o použití triggerů s konkrétním typem úložiště najdete v tématu Podporovaná zdrojová úložiště.
Pokud zadáte žádný aktivační událost nabízených oznámení, nasdílí do libovolné větve aktivaci sestavení.
Kanály YAML se ve výchozím nastavení konfigurují s triggerem CI ve všech větvích, pokud není povolené nastavení Zakázat implicitní trigger CI YAML . Nastavení triggeru Zakázat implicitní YAML CI je možné nakonfigurovat na úrovni organizace nebo na úrovni projektu. Pokud je povolené nastavení Zakázat implicitní trigger CI YAML , triggery CI pro kanály YAML nejsou povolené, pokud kanál YAML nemá trigger
oddíl. Výchozí hodnota pro Zakázat implicitní trigger CI YAML je false
.
Klíčové slovo má tři různé možnosti trigger
syntaxe: seznam větví, které se mají zahrnout, způsob zakázání triggerů CI a úplná syntaxe pro úplnou kontrolu.
Pokud zadáte exclude
klauzuli bez klauzule include
pro branches
, tags
nebo paths
, je to ekvivalentní zadání *
v klauzuli include
.
Důležité
Když zadáte trigger, kanál aktivují pouze větve, které explicitně nakonfigurujete pro zahrnutí. Nejprve se zpracují zahrnutí a pak se z daného seznamu odeberou vyloučení. Pokud zadáte vyloučení, ale žádné zahrnutí, nic se neaktivuje.
trigger: none
Zakažte triggery CI.
trigger: none # Disable CI triggers.
trigger
Řetězec. Povolené hodnoty: žádné.
Zakažte triggery CI.
Příklady
trigger: none # will disable CI builds entirely
trigger: seznam řetězců
Seznam větví, které aktivují spuštění
trigger: [ string ] # List of branches that trigger a run.
Typy seznamů
Typ | Description |
---|---|
řetězec | Seznam větví, které aktivují spuštění |
Příklady
trigger:
- main
- develop
trigger: batch, branches, paths, tags
Pro úplnou kontrolu nad triggerem CI použijte ovládací prvek úplné syntaxe.
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.
Vlastnosti
batch
boolean.
Zda se mají dávkové změny na větev.
branches
includeExcludeFilters.
Názvy větví, které se mají zahrnout nebo vyloučit pro aktivaci spuštění.
paths
includeExcludeFilters.
Cesty k souborům, které se mají zahrnout nebo vyloučit pro aktivaci spuštění.
tags
includeExcludeFilters.
Názvy značek, které se mají zahrnout nebo vyloučit pro aktivaci spuštění.
trigger: batch, branches, paths
Pro úplnou kontrolu nad triggerem CI použijte ovládací prvek úplné syntaxe.
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.
Vlastnosti
batch
boolean.
Zda se mají dávkové změny na větev.
branches
includeExcludeFilters.
Názvy větví, které se mají zahrnout nebo vyloučit pro aktivaci spuštění.
paths
includeExcludeFilters.
Cesty k souborům, které se mají zahrnout nebo vyloučit pro aktivaci spuštění.
Poznámky
Pokud máte mnoho členů týmu, kteří často nahrávají změny, možná budete chtít snížit počet spuštění, která spustíte. Pokud nastavíte batch
hodnotu true
, při spuštění kanálu systém počká, dokud se spuštění nedokončí, a pak spustí další spuštění se všemi změnami, které ještě nebyly sestaveny. Ve výchozím nastavení batch
je false
.
Důležité
batch
se nepodporuje v triggerech prostředků úložiště .
Další informace najdete v tématu Triggery – triggery CI a zvolte typ úložiště.
# specific branch build with batching
trigger:
batch: true
branches:
include:
- main
Příklady
trigger:
batch: true
branches:
include:
- features/*
exclude:
- features/experimental/*
paths:
exclude:
- README.md
Viz také
Přečtěte si další informace o aktivačních událostech a o tom, jak je zadat.