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.

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.

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.