definizione della pipeline

Una pipeline è costituita da una o più fasi che descrivono un processo CI/CD.

Implementazioni

Implementazione	Descrizione
pipeline: fasi	Pipeline con fasi.
pipeline: estende	Pipeline che estende un modello.
pipeline: processi	Pipeline con processi e una fase implicita.
pipeline: passaggi	Pipeline con passaggi e un processo implicito.

Commenti

Una pipeline è costituita da una o più fasi che descrivono un processo CI/CD. Le fasi sono le principali divisioni in una pipeline. Le fasi "Compila questa app", "Esegui questi test" e "Distribuisci in preproduzione" sono esempi validi.

Una fase è costituita da uno o più processi, ovvero unità di lavoro assegnabili allo stesso computer. È possibile organizzare le fasi e i processi in grafici dipendenze. Gli esempi includono "Esegui questa fase prima di quella" e "Questo processo dipende dall'output di tale processo".

Un processo è una serie lineare di passaggi. I passaggi possono essere attività, script o riferimenti a modelli esterni.

Questa gerarchia viene riflessa nella struttura di un file YAML, ad esempio:

- Pipeline
  - Stage A
    - Job 1
      - Step 1.1
      - Step 1.2
      - ...
    - Job 2
      - Step 2.1
      - Step 2.2
      - ...
  - Stage B
    - ...

Le pipeline semplici non richiedono tutti questi livelli. In una compilazione a processo singolo, ad esempio, è possibile omettere i contenitori per le fasi e i processi perché sono presenti solo passaggi. Poiché molte opzioni illustrate in questo articolo non sono necessarie e hanno impostazioni predefinite valide, è improbabile che le definizioni YAML includano tutte.

Se si dispone di una singola fase, è possibile omettere la stages parola chiave e specificare direttamente la parola chiave jobs:

# ... other pipeline-level keywords
jobs: [ job | template ]

Se si dispone di una singola fase e di un singolo processo, è possibile omettere le stages parole chiave e e jobs specificare direttamente la parola chiave steps :

# ... other pipeline-level keywords
steps: [ script | bash | pwsh | powershell | checkout | task | template | ... ]

Usare la name proprietà per configurare il numero di esecuzione della pipeline. Per altre informazioni, vedere Configurare numeri di esecuzione o compilazione.

pipeline: fasi

Pipeline con fasi.

stages: [ stage | template ] # Required. Stages are groups of jobs that can run without human intervention.
pool: string | pool # Pool where jobs in this pipeline will run unless otherwise specified.
name: string # Pipeline run number.
appendCommitMessageToRunName: boolean # Append the commit message to the build number. The default is true.
trigger: none | trigger | [ string ] # Continuous integration triggers.
parameters: [ parameter ] # Pipeline template parameters.
pr: none | pr | [ string ] # Pull request triggers.
schedules: [ cron ] # Scheduled triggers.
resources: # Containers and repositories used in the build.
  builds: [ build ] # List of build resources referenced by the pipeline.
  containers: [ container ] # List of container images.
  pipelines: [ pipeline ] # List of pipeline resources.
  repositories: [ repository ] # List of repository resources.
  webhooks: [ webhook ] # List of webhooks.
  packages: [ package ] # List of package resources.
variables: variables | [ variable ] # Variables for this pipeline.
lockBehavior: string # Behavior lock requests from this stage should exhibit in relation to other exclusive lock requests.

Proprietà

stagesfasi. Obbligatorio.
Le fasi sono gruppi di processi che possono essere eseguiti senza intervento umano.

poolpiscina.
Pool in cui verranno eseguiti i processi in questa pipeline, se non diversamente specificato.

name Stringa.
Numero di esecuzione della pipeline.

appendCommitMessageToRunNamebooleano.
Aggiungere il messaggio di commit al numero di build. Il valore predefinito è true.

triggertrigger.
Trigger di integrazione continua.

parametersparametri.
Parametri del modello di pipeline.

prpr.
Trigger di richiesta pull.

schedulespianificazioni.
Trigger pianificati.

resourcesrisorse.
Contenitori e repository usati nella compilazione.

variablesvariabili.
Variabili per questa pipeline.

lockBehavior Stringa.
Le richieste di blocco del comportamento da questa fase devono essere esposte in relazione ad altre richieste di blocco esclusive. sequenziale | runLatest.

Esempio

trigger:
- main

pool: 
  vmImage: ubuntu-latest

stages:
- stage: CI
  jobs:
  - job: CIWork
    steps:
    - script: "Do CI work"

- stage: Test
  jobs:
  - job: TestWork
    steps:
    - script: "Do test work"

pipeline: estende

Pipeline che estende un modello.

extends: # Required. Extends a template.
  template: string # The template referenced by the pipeline to extend.
  parameters: # Parameters used in the extend.
pool: string | pool # Pool where jobs in this pipeline will run unless otherwise specified.
name: string # Pipeline run number.
appendCommitMessageToRunName: boolean # Append the commit message to the build number. The default is true.
trigger: none | trigger | [ string ] # Continuous integration triggers.
parameters: [ parameter ] # Pipeline template parameters.
pr: none | pr | [ string ] # Pull request triggers.
schedules: [ cron ] # Scheduled triggers.
resources: # Containers and repositories used in the build.
  builds: [ build ] # List of build resources referenced by the pipeline.
  containers: [ container ] # List of container images.
  pipelines: [ pipeline ] # List of pipeline resources.
  repositories: [ repository ] # List of repository resources.
  webhooks: [ webhook ] # List of webhooks.
  packages: [ package ] # List of package resources.
variables: variables | [ variable ] # Variables for this pipeline.
lockBehavior: string # Behavior lock requests from this stage should exhibit in relation to other exclusive lock requests.

Proprietà

extendsestende. Obbligatorio.
Estende un modello.

poolpool.
Pool in cui verranno eseguiti processi in questa pipeline, a meno che non sia specificato in caso contrario.

name Stringa.
Numero di esecuzione della pipeline.

appendCommitMessageToRunNameboolean.
Aggiungere il messaggio di commit al numero di compilazione. Il valore predefinito è true.

triggertrigger.
Trigger di integrazione continua.

parametersparametri.
Parametri del modello di pipeline.

prpr.
Trigger di richiesta pull.

schedulespianificazioni.
Trigger pianificati.

resourcesrisorse.
Contenitori e repository usati nella compilazione.

variablesvariabili.
Variabili per questa pipeline.

lockBehavior Stringa.
Le richieste di blocco del comportamento da questa fase devono essere visualizzate in relazione ad altre richieste di blocco esclusive. sequenziale | runLatest.

pipeline: processi

Pipeline con processi e una fase implicita.

jobs: [ job | deployment | template ] # Required. Jobs represent units of work which can be assigned to a single agent or server.
pool: string | pool # Pool where jobs in this pipeline will run unless otherwise specified.
name: string # Pipeline run number.
appendCommitMessageToRunName: boolean # Append the commit message to the build number. The default is true.
trigger: none | trigger | [ string ] # Continuous integration triggers.
parameters: [ parameter ] # Pipeline template parameters.
pr: none | pr | [ string ] # Pull request triggers.
schedules: [ cron ] # Scheduled triggers.
resources: # Containers and repositories used in the build.
  builds: [ build ] # List of build resources referenced by the pipeline.
  containers: [ container ] # List of container images.
  pipelines: [ pipeline ] # List of pipeline resources.
  repositories: [ repository ] # List of repository resources.
  webhooks: [ webhook ] # List of webhooks.
  packages: [ package ] # List of package resources.
variables: variables | [ variable ] # Variables for this pipeline.
lockBehavior: string # Behavior lock requests from this stage should exhibit in relation to other exclusive lock requests.

Proprietà

jobsprocessi. Obbligatorio.
I processi rappresentano unità di lavoro che possono essere assegnate a un singolo agente o server.

poolpool.
Pool in cui verranno eseguiti processi in questa pipeline, a meno che non sia specificato in caso contrario.

name Stringa.
Numero di esecuzione della pipeline.

appendCommitMessageToRunNameboolean.
Aggiungere il messaggio di commit al numero di compilazione. Il valore predefinito è true.

triggertrigger.
Trigger di integrazione continua.

parametersparametri.
Parametri del modello di pipeline.

prpr.
Trigger di richiesta pull.

schedulespianificazioni.
Trigger pianificati.

resourcesrisorse.
Contenitori e repository usati nella compilazione.

variablesvariabili.
Variabili per questa pipeline.

lockBehavior Stringa.
Le richieste di blocco del comportamento da questa fase devono essere visualizzate in relazione ad altre richieste di blocco esclusive. sequenziale | runLatest.

Esempio

trigger:
- main

pool: 
  vmImage: ubuntu-latest

jobs:
- job: PreWork
  steps:
  - script: "Do pre-work"

- job: PostWork
  pool: windows-latest
  steps:
  - script: "Do post-work using a different hosted image"

pipeline: passaggi

Pipeline con passaggi e un processo implicito.

steps: [ task | script | powershell | pwsh | bash | checkout | download | downloadBuild | getPackage | publish | template | reviewApp ] # Required. A list of steps to run in this job.
strategy: strategy # Execution strategy for this job.
continueOnError: string # Continue running even on failure?
pool: string | pool # Pool where jobs in this pipeline will run unless otherwise specified.
container: string | container # Container resource name.
services: # Container resources to run as a service container.
  string: string # Name/value pairs
workspace: # Workspace options on the agent.
  clean: string # Which parts of the workspace should be scorched before fetching.
name: string # Pipeline run number.
appendCommitMessageToRunName: boolean # Append the commit message to the build number. The default is true.
trigger: none | trigger | [ string ] # Continuous integration triggers.
parameters: [ parameter ] # Pipeline template parameters.
pr: none | pr | [ string ] # Pull request triggers.
schedules: [ cron ] # Scheduled triggers.
resources: # Containers and repositories used in the build.
  builds: [ build ] # List of build resources referenced by the pipeline.
  containers: [ container ] # List of container images.
  pipelines: [ pipeline ] # List of pipeline resources.
  repositories: [ repository ] # List of repository resources.
  webhooks: [ webhook ] # List of webhooks.
  packages: [ package ] # List of package resources.
variables: variables | [ variable ] # Variables for this pipeline.
lockBehavior: string # Behavior lock requests from this stage should exhibit in relation to other exclusive lock requests.

Proprietà

stepspassaggi. Obbligatorio.
Elenco dei passaggi da eseguire in questo processo.

strategyjobs.job.strategy.
Strategia di esecuzione per questo processo.

continueOnError Stringa.
Continuare l'esecuzione anche in caso di errore?

poolpool.
Pool in cui verranno eseguiti processi in questa pipeline, a meno che non sia specificato in caso contrario.

containerjobs.job.container.
Nome risorsa contenitore.

services dizionario stringa.
Risorse contenitore da eseguire come contenitore di servizi.

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

name Stringa.
Numero di esecuzione della pipeline.

appendCommitMessageToRunNameboolean.
Aggiungere il messaggio di commit al numero di compilazione. Il valore predefinito è true.

triggertrigger.
Trigger di integrazione continua.

parametersparametri.
Parametri del modello di pipeline.

prpr.
Trigger di richiesta pull.

schedulespianificazioni.
Trigger pianificati.

resourcesrisorse.
Contenitori e repository usati nella compilazione.

variablesvariabili.
Variabili per questa pipeline.

lockBehavior Stringa.
Le richieste di blocco del comportamento da questa fase devono essere visualizzate in relazione ad altre richieste di blocco esclusive. sequenziale | runLatest.

Esempi

trigger:
- main

pool: 
  vmImage: ubuntu-latest

steps:
- script: "Hello world!"

Vedere anche

• Pipeline con più processi
• Trigger
• Variabili
• Formati dei numeri di compilazione