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.

Osservazioni:

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

Una fase è 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. Ad esempio, in una compilazione a singolo processo, è possibile omettere i contenitori per fasi e 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 parola chiave stages e specificare direttamente la parola chiave processi:

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

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

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

Usare la proprietà name per configurare il numero di esecuzione della pipeline. Per altre informazioni, vedere Configurare i numeri di esecuzione o di 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: sequential | runLatest # Behavior lock requests from this stage should exhibit in relation to other exclusive lock requests.

Proprietà

stages fasi. Obbligatorio.
Fasi sono gruppi di processi che possono essere eseguiti senza intervento umano.

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

name stringa.
numero di esecuzione della pipeline.

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

trigger trigger.
trigger di integrazione continua.

parameters parametri.
parametri del modello di pipeline.

pr pr.
trigger di richiesta pull.

schedules pianificazioni.
trigger pianificati.

resources risorse.
Contenitori e repository usati nella compilazione.

variables variabili.
Variabili per questa pipeline.

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

Esempi

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: sequential | runLatest # Behavior lock requests from this stage should exhibit in relation to other exclusive lock requests.

Proprietà

extends estende. Obbligatorio.
Estende un modello.

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

name stringa.
numero di esecuzione della pipeline.

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

trigger trigger.
trigger di integrazione continua.

parameters parametri.
parametri del modello di pipeline.

pr pr.
trigger di richiesta pull.

schedules pianificazioni.
trigger pianificati.

resources risorse.
Contenitori e repository usati nella compilazione.

variables variabili.
Variabili per questa pipeline.

lockBehavior stringa.
Richieste di blocco comportamento da questa fase devono essere esposte 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: sequential | runLatest # Behavior lock requests from this stage should exhibit in relation to other exclusive lock requests.

Proprietà

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

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

name stringa.
numero di esecuzione della pipeline.

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

trigger trigger.
trigger di integrazione continua.

parameters parametri.
parametri del modello di pipeline.

pr pr.
trigger di richiesta pull.

schedules pianificazioni.
trigger pianificati.

resources risorse.
Contenitori e repository usati nella compilazione.

variables variabili.
Variabili per questa pipeline.

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

Esempi

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: outputs | resources | all # 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: sequential | runLatest # Behavior lock requests from this stage should exhibit in relation to other exclusive lock requests.

Proprietà

steps passaggi. Obbligatorio.
Elenco di passaggi da eseguire in questo processo.

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

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

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

container jobs.job.container.
nome della risorsa contenitore.

services dizionario di stringhe.
Risorse contenitore da eseguire come contenitore del servizio.

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

name stringa.
numero di esecuzione della pipeline.

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

trigger trigger.
trigger di integrazione continua.

parameters parametri.
parametri del modello di pipeline.

pr pr.
trigger di richiesta pull.

schedules pianificazioni.
trigger pianificati.

resources risorse.
Contenitori e repository usati nella compilazione.

variables variabili.
Variabili per questa pipeline.

lockBehavior stringa.
Richieste di blocco comportamento da questa fase devono essere esposte 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 build