Condividi tramite


definizione pr

Un trigger di richiesta pull specifica i rami che causano l'esecuzione di una compilazione di una richiesta pull.

Definizioni che fanno riferimento a questa definizione: della pipeline

Implementazioni

Implementazione Descrizione
pr: nessuna Disabilitare i trigger di richiesta pull.
pr: elenco di stringhe Elenco di rami che attivano un'esecuzione.
pr: autoCancel, rami, percorsi, bozze Sintassi completa per il controllo completo.
Implementazione Descrizione
pr: nessuna Disabilitare i trigger di richiesta pull.
pr: elenco di stringhe Elenco di rami che attivano un'esecuzione.
pr: autoCancel, rami, percorsi Sintassi completa per il controllo completo.

Osservazioni:

Se non si specifica alcun trigger di richiesta pull, le richieste pull a qualsiasi ramo attivano una compilazione.

Sono disponibili tre opzioni di sintassi distinte per la parola chiave pr: un elenco di rami da includere, un modo per disabilitare i trigger di richiesta pull e la sintassi completa per il controllo completo.

Importante

I trigger di richiesta pull YAML sono supportati solo in GitHub e Bitbucket Cloud. Se si usa Azure Repos Git, è possibile configurare un criterio di ramo per la convalida della compilazione per attivare la pipeline di compilazione per la convalida.

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

pr: nessuno

Disabilitare i trigger di richiesta pull.

pr: none # Disable pull request triggers.

pr stringa. Valori consentiti: nessuno.

Disabilitare i trigger di richiesta pull.

Esempi

Sintassi di disabilitazione:

pr: none # will disable PR builds (but not CI builds)

pr: elenco di stringhe

Elenco di rami che attivano un'esecuzione.

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

Tipi di elenco

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

Osservazioni:

La sintassi dell'elenco specifica un elenco di rami che attivano un'esecuzione quando viene generata una richiesta pull o viene eseguito un push nel ramo di origine di una richiesta pull generata.

Esempi

Sintassi elenco:

pr:
- main
- develop

pr: autoCancel, rami, percorsi, bozze

Usare la sintassi completa quando è necessario il controllo completo del trigger della richiesta pull.

pr:
  autoCancel: boolean # Whether to cancel running PR builds when a new commit lands in the branch. Default: true.
  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.
  drafts: boolean # Whether to start a run when a draft PR is created. Default: true.

Proprietà

autoCancel booleano .
Indica se annullare le compilazioni pull in esecuzione quando un nuovo commit viene installato nel ramo. Valore predefinito: true.

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.

drafts booleano .
Indica se avviare un'esecuzione quando viene creata una bozza di richiesta pull. Valore predefinito: true.

pr: autoCancel, rami, percorsi

Sintassi completa per il controllo completo.

pr:
  autoCancel: boolean # Whether to cancel running PR builds when a new commit lands in the branch. Default: true.
  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à

autoCancel booleano .
Indica se annullare le compilazioni pull in esecuzione quando un nuovo commit viene installato nel ramo. Valore predefinito: true.

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.

Esempi

Sintassi completa:

pr:
  branches:
    include:
    - features/*
    exclude:
    - features/experimental/*
  paths:
    exclude:
    - README.md

Vedere anche

Altre informazioni sui trigger di richiesta pull e su come specificarli.