Triggerdefinition

  • Artikel

Ein Pushtrigger gibt an, welche Branches bewirken, dass ein Continuous Integration-Build ausgeführt wird.

Definitionen, die auf diese Definition verweisen: pipeline, resources.repositories.repository

Definitionen, die auf diese Definition verweisen: Pipeline

Implementierungen

Implementierung Beschreibung
Trigger: keine Deaktivieren Sie CI-Trigger.
Trigger: Zeichenfolgenliste Liste der Verzweigungen, die eine Ausführung auslösen.
Trigger: Batch, Branches, Pfade, Tags Vollständige Syntax für vollständige Kontrolle.
Implementierung Beschreibung
Trigger: keine Deaktivieren Sie CI-Trigger.
Trigger: Zeichenfolgenliste Liste der Verzweigungen, die eine Ausführung auslösen.
Trigger: Batch, Branches, Pfade Vollständige Syntax für vollständige Kontrolle.

Hinweise

Weitere Informationen zur Verwendung von Triggern mit einem bestimmten Repositorytyp finden Sie unter Unterstützte Quellrepositorys.

Wenn Sie keinen Pushtrigger angeben, löst das Pushen an einen beliebigen Branch einen Build aus.

YAML-Pipelines werden standardmäßig mit einem CI-Trigger für alle Branches konfiguriert, es sei denn, die Einstellung Implizite YAML-CI-Trigger deaktivieren ist aktiviert. Die Einstellung Implizite YAML-CI-Trigger deaktivieren kann auf organization- oder Projektebene konfiguriert werden. Wenn die Einstellung Implizierte YAML CI-Trigger deaktivieren aktiviert ist, werden CI-Trigger für YAML-Pipelines nicht aktiviert, wenn die YAML-Pipeline keinen Abschnitt enthält trigger . Der Standardwert für den impliziten YAML-CI-Trigger deaktivieren ist false.

Es gibt drei unterschiedliche Syntaxoptionen für das trigger-Schlüsselwort: eine Liste der einzuschließenden Branches, eine Möglichkeit zum Deaktivieren von CI-Triggern und die vollständige Syntax für die vollständige Steuerung.

Wenn Sie eine exclude-Klausel ohne eine include-Klausel für branches, tags oder paths angeben, ist dies gleichbedeutend mit der Angabe von * in der include-Klausel.

Wichtig

Wenn Sie einen Trigger angeben, lösen nur Branches, die Sie explizit für die Aufnahme konfigurieren, eine Pipeline aus. Zuerst werden eingeschlossene Branches verarbeitet, dann werden ausgeschlossene Branches aus dieser Liste entfernt. Wenn Sie einen Ausschluss, aber keine Einschlüsse angeben, wird nichts ausgelöst.

Trigger: keine

Deaktivieren Sie CI-Trigger.

trigger: none # Disable CI triggers.

trigger Schnur. Zulässige Werte: keine.

Deaktivieren Sie CI-Trigger.

Beispiele

trigger: none # will disable CI builds entirely

Trigger: Zeichenfolgenliste

Liste der Verzweigungen, die eine Ausführung auslösen.

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

Listentypen

Typ Beschreibung
Zeichenfolge Liste der Verzweigungen, die eine Ausführung auslösen.

Beispiele

trigger:
- main
- develop

Trigger: Batch, Branches, Pfade, Tags

Verwenden Sie das vollständige Syntaxsteuerelement für die vollständige Kontrolle über den CI-Trigger.

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.

Eigenschaften

batchBoolescher Wert.
Gibt an, ob Änderungen pro Branch als Batch verwendet werden sollen.

branchesincludeExcludeFilters.
Branchnamen, die zum Auslösen einer Ausführung eingeschlossen oder ausgeschlossen werden sollen.

pathsincludeExcludeFilters.
Dateipfade, die zum Auslösen einer Ausführung eingeschlossen oder ausgeschlossen werden sollen.

tagsincludeExcludeFilters.
Tagnamen, die zum Auslösen einer Ausführung eingeschlossen oder ausgeschlossen werden sollen.

Trigger: Batch, Branches, Pfade

Verwenden Sie das vollständige Syntaxsteuerelement für die vollständige Kontrolle über den CI-Trigger.

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.

Eigenschaften

batchBoolescher Wert.
Gibt an, ob Änderungen pro Branch als Batch verwendet werden sollen.

branchesincludeExcludeFilters.
Branchnamen, die zum Auslösen einer Ausführung eingeschlossen oder ausgeschlossen werden sollen.

pathsincludeExcludeFilters.
Dateipfade, die zum Auslösen einer Ausführung eingeschlossen oder ausgeschlossen werden sollen.

Hinweise

Wenn viele Teammitglieder häufig Änderungen hochladen, kann es sinnvoll sein, die Anzahl der gestarteten Ausführungen zu verringern. Wenn Sie batch auf true festlegen, wartet das System bei der Ausführung einer Pipeline, bis diese abgeschlossen ist, und startet dann eine weitere Ausführung mit allen Änderungen, die noch nicht kompiliert wurden. batch ist standardmäßig false.

Wichtig

batch wird in Repositoryressourcentriggern nicht unterstützt.

Weitere Informationen finden Sie unter Trigger – CI-Trigger, und wählen Sie Ihren Repositorytyp aus.

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

Beispiele

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

Weitere Informationen

Erfahren Sie mehr über Trigger und deren Angabe.