definizione pr

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

Definizioni che fanno riferimento a questa definizione: pipeline

Implementazioni

Implementazione	Descrizione
pr: nessuno	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.

Commenti

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

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

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.

Esempio

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
string	Elenco di rami che attivano un'esecuzione.

Commenti

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.

Esempio

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à

autoCancelbooleano.
Indica se annullare l'esecuzione delle compilazioni pull quando un nuovo commit viene eseguito nel ramo. Impostazione predefinita: true.

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

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

draftsbooleano.
Indica se avviare un'esecuzione quando viene creata una bozza di richiesta pull. Impostazione predefinita: true.

Esempio

Sintassi completa:

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

Vedi anche

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