Condividi tramite

definizione del trigger

  • Articolo

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: della pipeline

Implementazioni

Implementazione Descrizione
trigger : nessuna 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 : nessuna 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.

Osservazioni

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, esegue il push in qualsiasi ramo attiva una compilazione.

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

Sono disponibili tre opzioni di sintassi distinte per la parola chiave trigger: 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 clausola exclude senza una clausola include per branches, tagso paths, equivale a specificare * nella clausola include.

Importante

Quando si specifica un trigger, solo i rami configurati in modo esplicito per l'inclusione attivano una pipeline. Le inclusioni vengono elaborate per prime 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.

Esempi

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

Digitare Descrizione
corda Elenco di rami che attivano un'esecuzione.

Esempi

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à

batch booleano .
Indica se eseguire il batch delle modifiche per ogni ramo.

branches includeExcludeFilters.
nomi di ramo da includere o escludere per l'attivazione di un'esecuzione.

paths includeExcludeFilters.
Percorsi file da includere o escludere per l'attivazione di un'esecuzione.

tags includeExcludeFilters.
nomi di tag da includere o escludere per l'attivazione di 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à

batch booleano .
Indica se eseguire il batch delle modifiche per ogni ramo.

branches includeExcludeFilters.
nomi di ramo da includere o escludere per l'attivazione di un'esecuzione.

paths includeExcludeFilters.
Percorsi file da includere o escludere per l'attivazione di un'esecuzione.

Osservazioni

Se si hanno molti membri del team che caricano spesso le modifiche, è consigliabile 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 non ancora compilate. Per impostazione predefinita, batch è false.

Quando si specifica un ramo, un tag o un percorso, è possibile usare un nome esatto o un carattere jolly. Per altre informazioni, vedere caratteri jolly.

Importante

non è supportato nei trigger della risorsa 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.