pijplijndefinitie

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

Implementaties

Implementatie	Beschrijving
pijplijn: fasen	Pijplijn met fasen.
pijplijn: breidt uit	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 bestaat uit 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 naar preproductie' zijn goede voorbeelden.

Een fase is een of meer taken. Dit zijn werkeenheden die aan dezelfde machine kunnen worden toegewezen. U kunt zowel fasen als taken in afhankelijkheidsgrafieken rangschikken. Voorbeelden hiervan zijn 'Deze fase uitvoeren vóór die ene' 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 weergegeven 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 voor fasen en taken weglaten omdat er alleen stappen zijn. En omdat veel opties in dit artikel niet vereist zijn en goede standaardwaarden hebben, is het onwaarschijnlijk dat uw YAML-definities deze allemaal bevatten.

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

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

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

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

Gebruik de name eigenschap om het nummer van de pijplijnuitvoering te configureren. Zie Run- of buildnummers configureren voor 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: string # Behavior lock requests from this stage should exhibit in relation to other exclusive lock requests.

Eigenschappen

stagesfasen. Vereist.
Fasen zijn groepen taken die kunnen worden uitgevoerd zonder menselijke tussenkomst.

poolzwembad.
Pool waarin taken in deze pijplijn worden uitgevoerd, tenzij anders aangegeven.

name Tekenreeks.
Pijplijnuitvoeringsnummer.

appendCommitMessageToRunNameBooleaanse waarde.
Voeg het doorvoerbericht toe aan het buildnummer. De standaardwaarde is true.

triggertrigger.
Triggers voor continue integratie.

parametersparameters.
Parameters voor pijplijnsjablonen.

prpr.
Triggers voor pull-aanvragen.

schedulesplanningen.
Geplande triggers.

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

variablesvariabelen.
Variabelen voor deze pijplijn.

lockBehavior Tekenreeks.
Gedragsvergrendelingsaanvragen uit deze fase moeten worden weergegeven in relatie tot 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: breidt uit

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

Eigenschappen

extendswordt uitgebreid. Vereist.
Breidt een sjabloon uit.

poolzwembad.
Pool waarin taken in deze pijplijn worden uitgevoerd, tenzij anders aangegeven.

name Tekenreeks.
Pijplijnuitvoeringsnummer.

appendCommitMessageToRunNameBooleaanse waarde.
Voeg het doorvoerbericht toe aan het buildnummer. De standaardwaarde is true.

triggertrigger.
Triggers voor continue integratie.

parametersparameters.
Parameters voor pijplijnsjablonen.

prpr.
Triggers voor pull-aanvragen.

schedulesplanningen.
Geplande triggers.

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

variablesvariabelen.
Variabelen voor deze pijplijn.

lockBehavior Tekenreeks.
Gedragsvergrendelingsaanvragen uit deze fase moeten worden weergegeven in relatie tot 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: string # Behavior lock requests from this stage should exhibit in relation to other exclusive lock requests.

Eigenschappen

jobsjobs. Vereist.
Taken vertegenwoordigen werkeenheden die kunnen worden toegewezen aan één agent of server.

poolzwembad.
Pool waarin taken in deze pijplijn worden uitgevoerd, tenzij anders aangegeven.

name Tekenreeks.
Pijplijnuitvoeringsnummer.

appendCommitMessageToRunNameBooleaanse waarde.
Voeg het doorvoerbericht toe aan het buildnummer. De standaardwaarde is true.

triggertrigger.
Triggers voor continue integratie.

parametersparameters.
Parameters voor pijplijnsjablonen.

prpr.
Triggers voor pull-aanvragen.

schedulesplanningen.
Geplande triggers.

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

variablesvariabelen.
Variabelen voor deze pijplijn.

lockBehavior Tekenreeks.
Gedragsvergrendelingsaanvragen uit deze fase moeten worden weergegeven in relatie tot 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: 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.

Eigenschappen

stepsstappen. Vereist.
Een lijst met stappen die in deze taak moeten worden uitgevoerd.

strategyjobs.job.strategy.
Uitvoeringsstrategie voor deze taak.

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

poolzwembad.
Pool waarin taken in deze pijplijn worden uitgevoerd, tenzij anders aangegeven.

containerjobs.job.container.
Naam van containerresource.

services tekenreekswoordenlijst.
Containerresources die moeten worden uitgevoerd als een servicecontainer.

workspacewerkruimte.
Werkruimteopties op de agent.

name Tekenreeks.
Nummer van pijplijnuitvoering.

appendCommitMessageToRunNamebooleaanse waarde.
Voeg het doorvoerbericht toe aan het buildnummer. De standaardwaarde is true.

triggertrigger.
Triggers voor continue integratie.

parametersparameters.
Parameters voor pijplijnsjablonen.

prpr.
Triggers voor pull-aanvragen.

schedulesplanningen.
Geplande triggers.

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

variablesvariabelen.
Variabelen voor deze pijplijn.

lockBehavior Tekenreeks.
Gedragsvergrendelingsaanvragen uit deze fase moeten worden weergegeven in relatie tot andere exclusieve vergrendelingsaanvragen. sequentiële | runLatest.

Voorbeelden

trigger:
- main

pool: 
  vmImage: ubuntu-latest

steps:
- script: "Hello world!"

Zie ook

• Pijplijnen met meerdere taken
• Triggers
• Variabelen
• Getalnotaties bouwen