utlösardefinition

En push-utlösare anger vilka grenar som gör att en kontinuerlig integreringsversion körs.

Definitioner som refererar till den här definitionen: pipeline, resources.repositories.repository

Implementeringar

Genomförande	Beskrivning
utlösare: ingen	Inaktivera CI-utlösare.
utlösare: stränglista	Lista över grenar som utlöser en körning.
utlösare: batch, grenar, sökvägar, taggar	Fullständig syntax för fullständig kontroll.

Anmärkningar

Mer information om hur du använder utlösare med en specifik lagringsplatstyp finns i källlagringsplatser som stöds.

YAML-pipelines konfigureras som standard med en CI-utlösare på alla grenar, såvida inte Inaktivera underförstådda YAML CI-utlösare inställningen är aktiverad. Inställningen Inaktivera underförstådd YAML CI-utlösare kan konfigureras på organisationsnivå eller på projektnivå. När inställningen Inaktivera underförstådd YAML CI-utlösare är aktiverad aktiveras inte CI-utlösare för YAML-pipelines om YAML-pipelinen inte har något trigger avsnitt. Standardvärdet för Inaktivera underförstådd YAML CI-utlösare är false.

Det finns tre olika syntaxalternativ för nyckelordet trigger: en lista med grenar som ska inkluderas, ett sätt att inaktivera CI-utlösare och den fullständiga syntaxen för fullständig kontroll.

Om du anger en exclude-sats utan en include-sats för branches, tagseller paths, motsvarar det att ange * i include-satsen.

utlösare: ingen

Inaktivera CI-utlösare.

trigger: none # Disable CI triggers.

trigger sträng. Tillåtna värden: ingen.

Inaktivera CI-utlösare.

Exempel

trigger: none # will disable CI builds entirely

utlösare: stränglista

Lista över grenar som utlöser en körning.

trigger: [ string ] # List of branches that trigger a run.

Listtyper

Typ	Beskrivning
sträng	Lista över grenar som utlöser en körning.

Exempel

trigger:
- main
- develop

utlösare: batch, grenar, sökvägar, taggar

Använd den fullständiga syntaxkontrollen för fullständig kontroll över CI-utlösaren.

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.

Egenskaper

batch boolesk.
Om batchändringar ska utföras per gren.

branches includeExcludeFilters.
Grennamn som ska inkluderas eller exkluderas för att utlösa en körning.

paths includeExcludeFilters.
Filsökvägar som ska inkluderas eller exkluderas för att utlösa en körning.

tags includeExcludeFilters.
Taggnamn som ska inkluderas eller exkluderas för att utlösa en körning.

Anmärkningar

Om du ofta har många teammedlemmar som laddar upp ändringar kanske du vill minska antalet körningar som du startar. Om du anger batch till true, när en pipeline körs, väntar systemet tills körningen har slutförts och startar sedan en annan körning med alla ändringar som ännu inte har skapats. Som standard är batchfalse.

När du anger en gren, tagg eller sökväg kan du använda ett exakt namn eller ett jokertecken. Mer information finns i jokertecken.

Viktig

batch stöds inte i utlösare för lagringsplatsen.

Mer information finns i Utlösare – CI-utlösare och välj din lagringsplatstyp.

# specific branch build with batching
trigger:
  batch: true
  branches:
    include:
    - main

Exempel

trigger:
  batch: true
  branches:
    include:
    - features/*
    exclude:
    - features/experimental/*
  paths:
    exclude:
    - README.md

Se även

Läs mer om utlösare och hur du anger dem.