Sdílet prostřednictvím


definice triggeru

Trigger nabízených oznámení určuje, které větve způsobí spuštění sestavení kontinuální integrace.

Definice, které odkazují na tuto definici: kanál, resources.repositories.repository

Definice, které odkazují na tuto definici: kanál

Implementace

Implementace Popis
trigger : žádný Zakažte triggery CI.
trigger : seznamu řetězců Seznam větví, které aktivují spuštění
trigger : batch, větve, cesty, značky Úplná syntaxe pro úplné řízení
Implementace Popis
trigger : žádný Zakažte triggery CI.
trigger : seznamu řetězců Seznam větví, které aktivují spuštění
aktivační událost : dávka, větve, cesty Úplná syntaxe pro úplné řízení

Poznámky

Další informace o používání triggerů s konkrétním typem úložiště najdete v tématu Podporované zdrojové úložiště.

Pokud zadáte žádnou aktivační událost nabízených oznámení, odešle se do jakékoli větve aktivační událost sestavení.

Kanály YAML jsou ve výchozím nastavení nakonfigurované s triggerem CI ve všech větvích, pokud není povolené nastavení Zakázat implicitní trigger CI YAML. Nastavení Zakázat implicitní trigger CI JAZYKa YAML lze nakonfigurovat na úrovni organizace nebo na úrovni projektu. Pokud je povolené nastavení Zakázat implicitní trigger YAML CI, triggery CI pro kanály YAML nejsou povolené, pokud kanál YAML nemá trigger oddíl. Výchozí hodnota pro Zakázat implicitní trigger YAML CI je false.

Pro klíčové slovo trigger existují tři různé možnosti syntaxe: seznam větví, které se mají zahrnout, způsob, jak zakázat triggery CI a úplnou syntaxi pro úplné řízení.

Pokud zadáte klauzuli exclude bez klauzule include pro branches, tagsnebo paths, odpovídá určení * v klauzuli include.

Důležitý

Když zadáte trigger, aktivují kanál pouze větve, které explicitně nakonfigurujete pro zahrnutí. Zahrnutí se nejprve zpracovávají a vyloučení se z daného seznamu odeberou. Pokud zadáte vyloučení, ale žádné zahrnutí, nic se neaktivuje.

trigger: žádný

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 Popis
řetězec Seznam větví, které aktivují spuštění

Příklady

trigger:
- main
- develop

trigger: batch, větve, cesty, značky

Pro úplnou kontrolu nad triggerem CI použijte úplný ovládací prvek 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 logických.
, jestli se mají dávkové změny provádět pro každou 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é chcete 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 úplný ovládací prvek 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 logických.
, jestli se mají dávkové změny provádět pro každou 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é chcete zahrnout nebo vyloučit pro aktivaci spuštění.

Poznámky

Pokud máte mnoho členů týmu, kteří často nahrávají změny, můžete snížit počet spuštění, která začínáte. Pokud nastavíte batch na true, když je kanál spuštěný, systém počká, dokud se spuštění nedokončí, spustí další spuštění se všemi změnami, které ještě nebyly vytvořeny. Ve výchozím nastavení je batchfalse.

Při zadávání větve, značky nebo cesty můžete použít přesný název nebo zástupný znak. Další informace najdete v tématu zástupných znaků.

Důležitý

batch se v triggerech prostředků úložiště nepodporuje.

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 triggerech a o tom, jak je určit.