definizione pr

  • Articolo

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.
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 Sintassi completa per il controllo completo.
Implementazione Descrizione
pr: nessuno Disabilitare i trigger di richiesta pull.
pr: elenco di stringhe Elenco di rami che attivano un'esecuzione.
pr: rami, percorsi 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.

Importante

I trigger di richiesta pull YAML sono supportati solo in GitHub. 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 .

Importante

Quando si specifica un trigger di richiesta pull, 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.

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.

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à

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.

pr: rami, percorsi

Sintassi completa per il controllo completo.

pr:
  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à

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.

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.