Share via


definizione del trigger

Un trigger push specifica quali rami causano l'esecuzione di una compilazione di integrazione continua.

Definizioni che fanno riferimento a questa definizione: pipeline, resources.repository.repository

Definizioni che fanno riferimento a questa definizione: pipeline

Implementazioni

Implementazione Descrizione
trigger: nessuno Disabilitare i trigger CI.
trigger: elenco di stringhe Elenco di rami che attivano un'esecuzione.
trigger: batch, rami, percorsi, tag Sintassi completa per il controllo completo.
Implementazione Descrizione
trigger: nessuno Disabilitare i trigger CI.
trigger: elenco di stringhe Elenco di rami che attivano un'esecuzione.
trigger: batch, rami, percorsi Sintassi completa per il controllo completo.

Commenti

Per altre informazioni sull'uso di trigger con un tipo di repository specifico, vedere Repository di origine supportati.

Se non si specifica alcun trigger push, eseguire il push in qualsiasi ramo attivare una compilazione.

Le pipeline YAML sono configurate per impostazione predefinita con un trigger CI in tutti i rami, a meno che l'impostazione di trigger YAML implicito non sia abilitata. L'impostazione del trigger CI YAML implicito può essere configurata a livello di organizzazione o a livello di progetto. Quando l'impostazione del trigger YAML implicito è abilitata, i trigger CI per le pipeline YAML non sono abilitati se la pipeline YAML non ha una trigger sezione. Il valore predefinito per Disable implicit YAML CI trigger è false.

Esistono tre opzioni di sintassi distinte per la trigger parola chiave: un elenco di rami da includere, un modo per disabilitare i trigger CI e la sintassi completa per il controllo completo.

Se si specifica una excludeinclude clausola senza una clausola per branches, tagso paths, equivale a specificare * nella include clausola .

Importante

Quando si specifica un trigger, solo i rami configurati in modo esplicito per l'inclusione attivano una pipeline. Le inclusioni vengono elaborate prima e quindi le esclusioni vengono rimosse da tale elenco. Se si specifica un'esclusione ma nessuna inclusione, non viene attivato alcun trigger.

trigger: nessuno

Disabilitare i trigger CI.

trigger: none # Disable CI triggers.

trigger Stringa. Valori consentiti: nessuno.

Disabilitare i trigger CI.

Esempio

trigger: none # will disable CI builds entirely

trigger: elenco di stringhe

Elenco di rami che attivano un'esecuzione.

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

Tipi di elenco

Tipo Descrizione
string Elenco di rami che attivano un'esecuzione.

Esempio

trigger:
- main
- develop

trigger: batch, rami, percorsi, tag

Usare il controllo della sintassi completo per il controllo completo sul trigger CI.

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.

Proprietà

batchboolean.
Se eseguire il batch delle modifiche per ogni ramo.

branchesincludeExcludeFilters.
Nomi di ramo da includere o escludere per attivare un'esecuzione.

pathsincludeExcludeFilters.
Percorsi di file da includere o escludere per attivare un'esecuzione.

tagsincludeExcludeFilters.
Nomi di tag da includere o escludere per attivare un'esecuzione.

trigger: batch, rami, percorsi

Usare il controllo della sintassi completo per il controllo completo sul trigger CI.

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.

Proprietà

batchboolean.
Se eseguire il batch delle modifiche per ogni ramo.

branchesincludeExcludeFilters.
Nomi di ramo da includere o escludere per attivare un'esecuzione.

pathsincludeExcludeFilters.
Percorsi di file da includere o escludere per attivare un'esecuzione.

Commenti

Se si hanno molti membri del team che caricano spesso le modifiche, è possibile ridurre il numero di esecuzioni avviate. Se si imposta batch su true, quando una pipeline è in esecuzione, il sistema attende fino al completamento dell'esecuzione, quindi avvia un'altra esecuzione con tutte le modifiche che non sono ancora state compilate. Per impostazione predefinita, batch è false.

Importante

batch non è supportato nei trigger delle risorse del repository .

Per altre informazioni, vedere Trigger - TRIGGER CI e scegliere il tipo di repository.

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

Esempi

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

Vedere anche

Altre informazioni sui trigger e su come specificarli.