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, tagsnebo 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

batchboolean.
Zda se mají dávkové změny na větev.

branchesincludeExcludeFilters.
Názvy větví, které se mají zahrnout nebo vyloučit pro aktivaci spuštění.

pathsincludeExcludeFilters.
Cesty k souborům, které se mají zahrnout nebo vyloučit pro aktivaci spuštění.

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

batchboolean.
Zda se mají dávkové změny na větev.

branchesincludeExcludeFilters.
Názvy větví, které se mají zahrnout nebo vyloučit pro aktivaci spuštění.

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