Freigeben über

Triggerdefinition

  • Artikel

Ein Pushtrigger gibt an, welche Verzweigungen dazu führen, dass ein fortlaufender Integrationsbuild ausgeführt wird.

Definitionen, die auf diese Definition verweisen: Pipeline-, resources.repository.repository

Definitionen, die auf diese Definition verweisen: Pipeline-

Ausführungen

Implementierung Beschreibung
Trigger: keine Deaktivieren Sie CI-Trigger.
Trigger: Zeichenfolgenliste Liste der Verzweigungen, die eine Ausführung auslösen.
Trigger: Batch, Verzweigungen, 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, Verzweigungen, Pfade Vollständige Syntax für vollständige Kontrolle.

Bemerkungen

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

Wenn Sie keinen Pushtrigger angeben, lösen Pushvorgänge an einen Verzweigungsauslöser einen Build aus.

YAML-Pipelines sind standardmäßig mit einem CI-Trigger für alle Verzweigungen konfiguriert, es sei denn, der Konkludente YAML CI-Trigger deaktivieren Einstellung aktiviert ist. Die Deaktivieren implizierter YAML CI-Trigger Einstellung kann auf Organisationsebene oder auf Projektebene konfiguriert werden. Wenn die konkludente YAML CI-Trigger deaktivieren Einstellung aktiviert ist, werden CI-Trigger für YAML-Pipelines nicht aktiviert, wenn die YAML-Pipeline keinen trigger Abschnitt enthält. Der Standardwert für Impliziten YAML CI-Trigger deaktivieren ist false.

Es gibt drei unterschiedliche Syntaxoptionen für das schlüsselwort trigger: eine Liste der zu einschließenden Verzweigungen, 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, tagsoder pathsangeben, entspricht es der Angabe von * in der include-Klausel.

Wichtig

Wenn Sie einen Trigger angeben, werden nur Verzweigungen, die Sie explizit für den Einschlussauslöser einer Pipeline konfigurieren, angegeben. Einschlüsse werden zuerst verarbeitet, und dann werden Ausschlüsse aus dieser Liste entfernt. Wenn Sie einen Ausschluss, aber keine Einschlüsse angeben, wird nichts ausgelöst.

trigger: none

Deaktivieren Sie CI-Trigger.

trigger: none # Disable CI triggers.

trigger Zeichenfolge. 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

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

Beispiele

trigger:
- main
- develop

Trigger: Batch, Verzweigungen, Pfade, Tags

Verwenden Sie das vollständige Syntaxsteuerelement, um die volle Kontrolle über den CI-Trigger zu haben.

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

batch booleschen.
Gibt an, ob Änderungen pro Verzweigung batchweise vorgenommen werden sollen.

branches includeExcludeFilters.
Verzweigungsnamen, die zum Auslösen einer Ausführung eingeschlossen oder ausgeschlossen werden sollen.

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

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

Trigger: Batch, Verzweigungen, Pfade

Verwenden Sie das vollständige Syntaxsteuerelement, um die volle Kontrolle über den CI-Trigger zu haben.

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

batch booleschen.
Gibt an, ob Änderungen pro Verzweigung batchweise vorgenommen werden sollen.

branches includeExcludeFilters.
Verzweigungsnamen, die zum Auslösen einer Ausführung eingeschlossen oder ausgeschlossen werden sollen.

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

Bemerkungen

Wenn Sie viele Teammitglieder häufig Änderungen hochladen, können Sie die Anzahl der gestarteten Ausführungen verringern. Wenn Sie batch auf truefestlegen, wartet das System, wenn eine Pipeline ausgeführt wird, bis die Ausführung abgeschlossen ist, und startet dann eine weitere Ausführung mit allen Änderungen, die noch nicht erstellt wurden. Standardmäßig ist batchfalse.

Wenn Sie eine Verzweigung, ein Tag oder einen Pfad angeben, können Sie einen genauen Namen oder einen Wildcardnamen verwenden. Weitere Informationen finden Sie unter .

Wichtig

batch wird in Repositoryressource Trigger nicht unterstützt.

Weitere Informationen finden Sie unter Trigger – CI-Trigger und wählen 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

Siehe auch

Erfahren Sie mehr über Trigger und wie Sie diese angeben.