pijplijndefinitie

Een pijplijn is een of meer fasen die een CI/CD-proces beschrijven.

Implementaties

Implementatie	Beschrijving
-pijplijn: fasen	Pijplijn met fasen.
-pijplijn: breidt	Pijplijn waarmee een sjabloon wordt uitgebreid.
-pijplijn: taken	Pijplijn met taken en één impliciete fase.
-pijplijn: stappen	Pijplijn met stappen en één impliciete taak.

Opmerkingen

Een pijplijn is een of meer fasen die een CI/CD-proces beschrijven. Fasen zijn de belangrijkste divisies in een pijplijn. De fasen 'Deze app bouwen', 'Deze tests uitvoeren' en 'Implementeren in preproductie' zijn goede voorbeelden.

Een fase is een of meer taken, die werkeenheden zijn die aan dezelfde machine kunnen worden toegewezen. U kunt zowel fasen als taken in afhankelijkheidsgrafieken rangschikken. Voorbeelden zijn 'Voer deze fase vóór die fase uit' en 'Deze taak is afhankelijk van de uitvoer van die taak'.

Een taak is een lineaire reeks stappen. Stappen kunnen taken, scripts of verwijzingen naar externe sjablonen zijn.

Deze hiërarchie wordt weerspiegeld in de structuur van een YAML-bestand, zoals:

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

Voor eenvoudige pijplijnen zijn niet al deze niveaus vereist. In een build met één taak kunt u bijvoorbeeld de containers weglaten voor fasen en taken, omdat er slechts stappen zijn. En omdat veel opties in dit artikel niet vereist zijn en goede standaardwaarden hebben, zijn uw YAML-definities waarschijnlijk niet allemaal opgenomen.

Als u één fase hebt, kunt u het trefwoord stages weglaten en het taken trefwoord rechtstreeks opgeven:

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

Als u één fase en één taak hebt, kunt u de stages en jobs trefwoorden weglaten en direct de stappen trefwoord opgeven:

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

Gebruik de eigenschap name om het pijplijnuitvoeringsnummer te configureren. Zie Run- of buildnummers configurerenvoor meer informatie.

pijplijn: fasen

Pijplijn met fasen.

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.

Eigenschappen

stages fasen. Verplicht.
fasen zijn groepen taken die zonder menselijke tussenkomst kunnen worden uitgevoerd.

pool zwembad.
pool waar taken in deze pijplijn worden uitgevoerd, tenzij anders is opgegeven.

name tekenreeks.
pijplijnuitvoeringsnummer.

appendCommitMessageToRunName booleaanse.
Voeg het doorvoerbericht toe aan het buildnummer. De standaardwaarde is waar.

trigger trigger.
continue integratietriggers.

parameters parameters.
pijplijnsjabloonparameters.

pr pr.
pull-aanvraagtriggers.

schedules planningen.
geplande triggers.

resources resources.
Containers en opslagplaatsen die worden gebruikt in de build.

variables variabelen.
variabelen voor deze pijplijn.

lockBehavior tekenreeks.
Gedragsvergrendelingsaanvragen uit deze fase moeten worden weergegeven ten opzichte van andere exclusieve vergrendelingsaanvragen. sequentiële | runLatest.

Voorbeelden

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"

pijplijn: uitbreiden

Pijplijn waarmee een sjabloon wordt uitgebreid.

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.

Eigenschappen

extends breidtuit. Verplicht.
een sjabloon uitbreiden.

pool zwembad.
pool waar taken in deze pijplijn worden uitgevoerd, tenzij anders is opgegeven.

name tekenreeks.
pijplijnuitvoeringsnummer.

appendCommitMessageToRunName booleaanse.
Voeg het doorvoerbericht toe aan het buildnummer. De standaardwaarde is waar.

trigger trigger.
continue integratietriggers.

parameters parameters.
pijplijnsjabloonparameters.

pr pr.
pull-aanvraagtriggers.

schedules planningen.
geplande triggers.

resources resources.
Containers en opslagplaatsen die worden gebruikt in de build.

variables variabelen.
variabelen voor deze pijplijn.

lockBehavior tekenreeks.
Gedragsvergrendelingsaanvragen uit deze fase moeten worden weergegeven ten opzichte van andere exclusieve vergrendelingsaanvragen. sequentiële | runLatest.

pijplijn: taken

Pijplijn met taken en één impliciete fase.

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.

Eigenschappen

jobs taken. Verplicht.
taken vertegenwoordigen werkeenheden die aan één agent of server kunnen worden toegewezen.

pool zwembad.
pool waar taken in deze pijplijn worden uitgevoerd, tenzij anders is opgegeven.

name tekenreeks.
pijplijnuitvoeringsnummer.

appendCommitMessageToRunName booleaanse.
Voeg het doorvoerbericht toe aan het buildnummer. De standaardwaarde is waar.

trigger trigger.
continue integratietriggers.

parameters parameters.
pijplijnsjabloonparameters.

pr pr.
pull-aanvraagtriggers.

schedules planningen.
geplande triggers.

resources resources.
Containers en opslagplaatsen die worden gebruikt in de build.

variables variabelen.
variabelen voor deze pijplijn.

lockBehavior tekenreeks.
Gedragsvergrendelingsaanvragen uit deze fase moeten worden weergegeven ten opzichte van andere exclusieve vergrendelingsaanvragen. sequentiële | runLatest.

Voorbeelden

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"

pijplijn: stappen

Pijplijn met stappen en één impliciete taak.

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.

Eigenschappen

steps stappen. Verplicht.
Een lijst met stappen die in deze taak moeten worden uitgevoerd.

strategy jobs.job.strategy.
uitvoeringsstrategie voor deze taak.

continueOnError tekenreeks.
Doorgaan met uitvoeren, zelfs bij een fout?

pool zwembad.
pool waar taken in deze pijplijn worden uitgevoerd, tenzij anders is opgegeven.

container jobs.job.container.
containerresourcenaam.

services tekenreekswoordenlijst.
Container-resources die moeten worden uitgevoerd als een servicecontainer.

workspace werkruimte.
werkruimteopties op de agent.

name tekenreeks.
pijplijnuitvoeringsnummer.

appendCommitMessageToRunName booleaanse.
Voeg het doorvoerbericht toe aan het buildnummer. De standaardwaarde is waar.

trigger trigger.
continue integratietriggers.

parameters parameters.
pijplijnsjabloonparameters.

pr pr.
pull-aanvraagtriggers.

schedules planningen.
geplande triggers.

resources resources.
Containers en opslagplaatsen die worden gebruikt in de build.

variables variabelen.
variabelen voor deze pijplijn.

lockBehavior tekenreeks.
Gedragsvergrendelingsaanvragen uit deze fase moeten worden weergegeven ten opzichte van andere exclusieve vergrendelingsaanvragen. sequentiële | runLatest.

Voorbeelden

trigger:
- main

pool: 
  vmImage: ubuntu-latest

steps:
- script: "Hello world!"

Zie ook

• Pijplijnen met meerdere taken
• Triggermomenten
• Variabelen
• buildnummernotaties