Informazioni di riferimento sullo schema YAML per Azure Pipelines

Le informazioni di riferimento sullo schema YAML per Azure Pipelines sono un riferimento dettagliato per le pipeline YAML che elencano tutte le sintassi YAML supportate e le relative opzioni disponibili.

Per creare una pipeline YAML, iniziare con la definizione della pipeline. Per altre informazioni sulla creazione di pipeline YAML, vedere Personalizzare la pipeline.

Il riferimento allo schema YAML non copre le attività. Per altre informazioni sulle attività, vedere l'indice attività di Azure Pipelines.

Definizioni

della pipeline
Una pipeline è una o più fasi che descrivono un processo CI/CD. La definizione della pipeline contiene la documentazione per le proprietà del livello radice, ad esempio name.

estende
Estende una pipeline usando un modello.

processi
Specifica i processi che costituiscono il lavoro di una fase.

jobs.deployment
un processo di distribuzione è un tipo speciale di processo. Si tratta di una raccolta di passaggi da eseguire in sequenza nell'ambiente.

jobs.deployment.environment
Nome dell'ambiente di destinazione e facoltativamente un nome di risorsa per registrare la cronologia di distribuzione; format: environment-name.resource-name.

jobs.deployment.strategy
strategia di esecuzione per questa distribuzione.

jobs.deployment.strategy.canary
strategia di distribuzione Canary.

jobs.deployment.strategy.rolling
strategia di distribuzione in sequenza.

jobs.deployment.strategy.runOnce
strategia di distribuzione RunOnce.

jobs.job
Un processo è una raccolta di passaggi eseguiti da un agente o in un server.

jobs.job.container
nome della risorsa contenitore.

jobs.job.strategy
strategia di esecuzione per questo processo.

jobs.job.uses
Tutte le risorse richieste da questo processo a cui non si fa già riferimento.

jobs.template
Set di processi definiti in un modello.

parametri di
Specifica i parametri di runtime passati a una pipeline.

parameters.parameter
parametri del modello di pipeline.

pool
Quale pool usare per un processo della pipeline.

pool
richieste (per un pool privato).

pr
trigger di richiesta pull.

risorse
Risorse specifica compilazioni, repository, pipeline e altre risorse usate dalla pipeline.

resources.build
Elenco di risorse di compilazione a cui fa riferimento la pipeline.

resources.build.build
Una risorsa di compilazione usata per fare riferimento agli artefatti da un'esecuzione.

resources.containers
Elenco di immagini del contenitore.

resources.containers.container
Una risorsa contenitore usata per fare riferimento a un'immagine del contenitore.

resources.containers.container.trigger
Specificare nessuno per disabilitare, true per attivare tutti i tag di immagine o usare la sintassi completa come descritto negli esempi seguenti.

resources.packages
Elenco delle risorse del pacchetto.

resources.packages.package
Una risorsa pacchetto usata per fare riferimento a un pacchetto GitHub NuGet o npm.

resources.pipelines
Elenco di risorse della pipeline.

resources.pipelines.pipeline
Una risorsa della pipeline.

resources.pipelines.pipeline.trigger
Specificare nessuno da disabilitare, true per includere tutti i rami o usare la sintassi completa come descritto negli esempi seguenti.

resources.pipelines.pipeline.trigger.branches
Rami da includere o escludere per l'attivazione di un'esecuzione.

resources.repository
Elenco di risorse del repository.

resources.repository.repository
una risorsa del repository viene usata per fare riferimento a un repository aggiuntivo nella pipeline.

resources.webhooks
Elenco di webhook.

resources.webhooks.webhook
Una risorsa webhook consente di integrare la pipeline con un servizio esterno per automatizzare il flusso di lavoro.

resources.webhooks.webhook.filters
Elenco di filtri trigger.

resources.webhooks.webhook.filters.filter
filtro trigger di risorse webhook.

pianificazioni
L'elenco pianificazioni specifica i trigger pianificati per la pipeline.

schedules.cron
Un trigger pianificato specifica una pianificazione in base alla quale vengono compilati i rami.

fasi
Stages sono una raccolta di processi correlati.

stage.stage
fase A è una raccolta di processi correlati.

stages.template
È possibile definire un set di fasi in un file e usarlo più volte in altri file.

passaggi
Passaggi sono una sequenza lineare di operazioni che costituiscono un processo.

steps.bash
Esegue uno script in Bash in Windows, macOS e Linux.

steps.checkout
Configurare il modo in cui la pipeline estrae il codice sorgente.

steps.download
Scarica elementi associati all'esecuzione corrente o da un'altra pipeline di Azure associata come risorsa della pipeline.

steps.downloadBuild
Scarica gli artefatti di compilazione.

steps.getPackage
Scarica un pacchetto da un feed di gestione pacchetti in Azure Artifacts o Azure DevOps Server.

steps.powershell
Esegue uno script usando Windows PowerShell (in Windows) o pwsh (Linux e macOS).

steps.publish
Pubblica (carica) un file o una cartella come artefatto della pipeline che altri processi e pipeline possono utilizzare.

steps.pwsh
Esegue uno script in PowerShell Core in Windows, macOS e Linux.

steps.reviewApp
Download crea una risorsa in modo dinamico in un provider di fasi di distribuzione.

steps.script
Esegue uno script usando cmd.exe in Windows e Bash in altre piattaforme.

steps.task
Esegue un'attività.

steps.template
Definire un set di passaggi in un file e usarlo più volte in un altro file.

di destinazione
Attività eseguite in un contesto di esecuzione, ovvero l'host dell'agente o un contenitore.

target.settableVariables
Restrizioni sulle variabili che è possibile impostare.

trigger
trigger di integrazione continua (push).

variabili
Definire le variabili usando coppie nome/valore.

variables.group
variabili di riferimento da un gruppo di variabili.

variables.name
Definire le variabili usando il nome e la sintassi completa.

variables.template
Definire le variabili in un modello.

Supporto delle definizioni

Nota

Le definizioni di supporto non sono destinate all'uso diretto in una pipeline. Le definizioni di supporto vengono usate solo come parte di altre definizioni e sono incluse qui per riferimento.

deployHook
Usato per eseguire i passaggi per distribuire l'applicazione.

includeExcludeFilters
Elenchi di elementi da includere o escludere.

includeExcludeStringFilters
Elementi da includere o escludere.

mountReadOnly
Volumi per montare di sola lettura, il valore predefinito è false.

onFailureHook
Usato per eseguire i passaggi per le azioni di rollback o la pulizia.

onSuccessHook
Usato per eseguire i passaggi per le azioni di rollback o la pulizia.

onSuccessOrFailureHook
Usato per eseguire i passaggi per le azioni di rollback o la pulizia.

postRouteTrafficHook
Usato per eseguire i passaggi dopo il routing del traffico. In genere, queste attività monitorano l'integrità della versione aggiornata per l'intervallo definito.

preDeployHook
Usato per eseguire i passaggi che inizializzano le risorse prima dell'avvio della distribuzione dell'applicazione.

routeTrafficHook
Usato per eseguire i passaggi che servono il traffico alla versione aggiornata.

dell'area di lavoro di
Opzioni dell'area di lavoro nell'agente.

Convenzioni della documentazione dello schema YAML

Il riferimento allo schema YAML è una guida di riferimento dettagliata alle pipeline YAML di Azure Pipelines. Include un catalogo di tutte le funzionalità YAML supportate e le opzioni disponibili.

Ecco le convenzioni di sintassi usate nel riferimento allo schema YAML.

• A sinistra di : è una parola chiave letterale usata nelle definizioni della pipeline.
• A destra di : è presente un tipo di dati. Il tipo di dati può essere un tipo primitivo come stringa o un riferimento a una struttura avanzata definita altrove in questo riferimento.
• La notazione [tipo di dati] indica una matrice del tipo di definizione indicato. Ad esempio, [ string ] è una matrice di stringhe.
• La notazione {datatype:datatype} indica un mapping di un tipo di dati a un altro. Ad esempio, { string: string } è un mapping di stringhe a stringhe.
• Il simbolo | indica che sono disponibili più tipi di dati per la parola chiave . Ad esempio, job | template indica che è consentita una definizione di processo o un riferimento al modello.

Vedere anche

Questo riferimento illustra lo schema di un file YAML di Azure Pipelines. Per informazioni sulle nozioni di base di YAML, vedere Learn YAML in Y Minutes. Azure Pipelines non supporta tutte le funzionalità YAML. Le funzionalità non supportate includono ancoraggi, chiavi complesse e set. Inoltre, a differenza di YAML standard, Azure Pipelines dipende dalla visualizzazione di stage, job, tasko un collegamento a un'attività come script come prima chiave in un mapping.