pipelinedefinition

En pipeline är ett eller flera steg som beskriver en CI/CD-process.

Implementeringar

Genomförande	Beskrivning
pipeline: steg	Pipeline med steg.
pipeline: utökar	Pipeline som utökar en mall.
pipeline: jobb	Pipeline med jobb och en implicit fas.
pipeline: steg	Pipeline med steg och ett implicit jobb.

Anmärkningar

En pipeline är ett eller flera steg som beskriver en CI/CD-process. Faser är de viktigaste divisionerna i en pipeline. Stegen "Skapa den här appen", "Kör dessa tester" och "Distribuera till förproduktion" är bra exempel.

En fas är ett eller flera jobb, som är arbetsenheter som kan tilldelas till samma dator. Du kan ordna både steg och jobb i beroendediagram. Exempel är "Kör den här fasen före den" och "Det här jobbet beror på utdata från jobbet.".

Ett jobb är en linjär serie steg. Steg kan vara uppgifter, skript eller referenser till externa mallar.

Den här hierarkin återspeglas i strukturen för en YAML-fil som:

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

Enkla pipelines kräver inte alla dessa nivåer. I en enstaka jobbversion kan du till exempel utelämna containrarna för faser och jobb eftersom det bara finns steg. Och eftersom många alternativ som visas i den här artikeln inte krävs och har bra standardvärden, kommer dina YAML-definitioner sannolikt inte att inkludera alla.

Om du har en enda fas kan du utelämna nyckelordet stages och direkt ange jobb nyckelord:

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

Om du har en enda fas och ett enda jobb kan du utelämna nyckelorden stages och jobs och direkt ange steg nyckelord:

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

Använd egenskapen name för att konfigurera pipelinekörningsnumret. Mer information finns i Konfigurera körnings- eller byggnummer.

pipeline: faser

Pipeline med steg.

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.

Egenskaper

stages steg. Obligatoriskt.
Faser är grupper av jobb som kan köras utan mänsklig inblandning.

pool pool.
pool där jobb i den här pipelinen körs om inget annat anges.

name sträng.
pipelinekörningsnummer.

appendCommitMessageToRunName boolesk.
Lägg till incheckningsmeddelandet i versionsnumret. Standardvärdet är sant.

trigger utlösare.
Utlösare för kontinuerlig integrering.

parameters parametrar.
Pipeline-mallparametrar.

pr pr.
Utlösare för pull-begäran.

schedules schemalägger.
schemalagda utlösare.

resources resurser.
containrar och lagringsplatser som används i bygget.

variables variabler.
variabler för den här pipelinen.

lockBehavior sträng.
Beteendelåsbegäranden från den här fasen bör visas i förhållande till andra exklusiva låsbegäranden. sekventiell | runLatest.

Exempel

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: utökar

Pipeline som utökar en mall.

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.

Egenskaper

extends utökar. Obligatoriskt.
Utökar en mall.

pool pool.
pool där jobb i den här pipelinen körs om inget annat anges.

name sträng.
pipelinekörningsnummer.

appendCommitMessageToRunName boolesk.
Lägg till incheckningsmeddelandet i versionsnumret. Standardvärdet är sant.

trigger utlösare.
Utlösare för kontinuerlig integrering.

parameters parametrar.
Pipeline-mallparametrar.

pr pr.
Utlösare för pull-begäran.

schedules schemalägger.
schemalagda utlösare.

resources resurser.
containrar och lagringsplatser som används i bygget.

variables variabler.
variabler för den här pipelinen.

lockBehavior sträng.
Beteendelåsbegäranden från den här fasen bör visas i förhållande till andra exklusiva låsbegäranden. sekventiell | runLatest.

pipeline: jobb

Pipeline med jobb och en implicit fas.

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.

Egenskaper

jobs jobb. Obligatoriskt.
Jobb representerar arbetsenheter som kan tilldelas till en enda agent eller server.

pool pool.
pool där jobb i den här pipelinen körs om inget annat anges.

name sträng.
pipelinekörningsnummer.

appendCommitMessageToRunName boolesk.
Lägg till incheckningsmeddelandet i versionsnumret. Standardvärdet är sant.

trigger utlösare.
Utlösare för kontinuerlig integrering.

parameters parametrar.
Pipeline-mallparametrar.

pr pr.
Utlösare för pull-begäran.

schedules schemalägger.
schemalagda utlösare.

resources resurser.
containrar och lagringsplatser som används i bygget.

variables variabler.
variabler för den här pipelinen.

lockBehavior sträng.
Beteendelåsbegäranden från den här fasen bör visas i förhållande till andra exklusiva låsbegäranden. sekventiell | runLatest.

Exempel

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: steg

Pipeline med steg och ett implicit jobb.

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.

Egenskaper

steps steg. Obligatoriskt.
En lista med steg som ska köras i det här jobbet.

strategy jobs.job.strategy.
Körningsstrategi för det här jobbet.

continueOnError sträng.
Vill du fortsätta köra även vid fel?

pool pool.
pool där jobb i den här pipelinen körs om inget annat anges.

container jobs.job.container.
containerresursnamn.

services strängordlista.
containerresurser som ska köras som en tjänstcontainer.

workspace arbetsyta.
arbetsytealternativ på agenten.

name sträng.
pipelinekörningsnummer.

appendCommitMessageToRunName boolesk.
Lägg till incheckningsmeddelandet i versionsnumret. Standardvärdet är sant.

trigger utlösare.
Utlösare för kontinuerlig integrering.

parameters parametrar.
Pipeline-mallparametrar.

pr pr.
Utlösare för pull-begäran.

schedules schemalägger.
schemalagda utlösare.

resources resurser.
containrar och lagringsplatser som används i bygget.

variables variabler.
variabler för den här pipelinen.

lockBehavior sträng.
Beteendelåsbegäranden från den här fasen bör visas i förhållande till andra exklusiva låsbegäranden. sekventiell | runLatest.

Exempel

trigger:
- main

pool: 
  vmImage: ubuntu-latest

steps:
- script: "Hello world!"

Se även

• pipelines med flera jobb
• utlöser
• Variabler
• Skapa talformat