Pipelinedefinition

Eine Pipeline umfasst eine oder mehrere Phasen, die einen CI/CD-Prozess beschreiben.

Implementierungen

Implementierung	Beschreibung
Pipeline: Phasen	Pipeline mit Phasen.
Pipeline: erweitert	Pipeline, die eine Vorlage erweitert.
Pipeline: Aufträge	Pipeline mit Aufträgen und einer impliziten Phase.
Pipeline: Schritte	Pipeline mit Schritten und einem impliziten Auftrag.

Hinweise

Eine Pipeline umfasst eine oder mehrere Phasen, die einen CI/CD-Prozess beschreiben. Stages sind die wichtigsten Bereiche in einer Pipeline. Die Phasen „Diese App erstellen“, „Diese Tests ausführen“ und „In Vorproduktion bereitstellen“ sind gute Beispiele.

Eine Phase besteht aus mindestens einem Auftrag, wobei es sich um Arbeitseinheiten handelt, die demselben Computer zugewiesen werden können. Sie können Phasen und Aufträge in Abhängigkeitsdiagrammen anordnen. Beispiele hierfür sind „Diese Phase vor jener ausführen“ und „Dieser Auftrag hängt von der Ausgabe jenes Auftrags ab“.

Ein Auftrag ist eine lineare Abfolge von Schritten. Schritte können Aufgaben, Skripts oder Verweise auf externe Vorlagen sein.

Diese Hierarchie wird in der Struktur einer YAML-Datei wie der folgenden widergespiegelt:

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

Für einfache Pipelines sind nicht alle diese Ebenen erforderlich. In einem Einzelauftragsbuild können Sie beispielsweise die Container für Phasen und Aufträge weglassen, da nur Schritte vorhanden sind. Da viele in diesem Artikel gezeigte Optionen nicht erforderlich sind und über gute Standardwerte verfügen, ist es unwahrscheinlich, dass Ihre YAML-Definitionen alle enthalten.

Wenn Sie über eine einzelne Phase verfügen, können Sie die stages Schlüsselwort (keyword) weglassen und die Aufträge Schlüsselwort (keyword) direkt angeben:

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

Wenn Sie über eine einzelne Stage und einen einzelnen Auftrag verfügen, können Sie die Schlüsselwörter stages und jobs weglassen und direkt das Schlüsselwort steps angeben:

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

Verwenden Sie die name -Eigenschaft, um die Pipelineausführungsnummer zu konfigurieren. Weitere Informationen finden Sie unter Konfigurieren von Ausführungs- oder Buildnummern.

Pipeline: Phasen

Pipeline mit Phasen.

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.

Eigenschaften

stages-Phasen. Erforderlich.
Phasen sind Gruppen von Aufträgen, die ohne menschliches Eingreifen ausgeführt werden können.

pool-Pool.
Pool, in dem Aufträge in dieser Pipeline ausgeführt werden, sofern nicht anders angegeben.

name Schnur.
Pipelineausführungsnummer.

appendCommitMessageToRunNameBoolescher Wert.
Fügen Sie die Commitnachricht an die Buildnummer an. Der Standardwert ist „true“.

trigger-Trigger aus.
Continuous Integrationstrigger.

parameters-Parametern.
Pipelinevorlagenparameter.

prpr.
Pull Request-Trigger.

schedulesZeitpläne.
Geplante Trigger.

resources-Ressourcen.
Container und Repositorys, die im Build verwendet werden.

variables-Variablen.
Variablen für diese Pipeline.

lockBehavior Schnur.
Verhaltenssperranforderungen aus dieser Phase sollten in Bezug auf andere exklusive Sperranforderungen angezeigt werden. sequenziell | runLatest.

Beispiele

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

Pipeline, die eine Vorlage erweitert.

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.

Eigenschaften

extendserweitert. Erforderlich.
Erweitert eine Vorlage.

poolPool.
Pool, in dem Aufträge in dieser Pipeline ausgeführt werden, sofern nicht anders angegeben.

name Schnur.
Pipelineausführungsnummer.

appendCommitMessageToRunNameBoolesch.
Fügen Sie die Commitnachricht an die Buildnummer an. Der Standardwert ist „true“.

triggerTrigger.
Trigger für continuous Integration.

parametersparametern.
Pipelinevorlagenparameter.

prpr.
Pull Request-Trigger.

schedulesZeitpläne.
Geplante Trigger.

resourcesRessourcen.
Container und Repositorys, die im Build verwendet werden.

variablesvariablen.
Variablen für diese Pipeline.

lockBehavior Schnur.
Verhaltenssperranforderungen aus dieser Phase sollten in Bezug auf andere exklusive Sperranforderungen angezeigt werden. sequenziell | runLatest.

Pipeline: Aufträge

Pipeline mit Aufträgen und einer impliziten Phase.

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.

Eigenschaften

jobs-Aufträge. Erforderlich.
Aufträge stellen Arbeitseinheiten dar, die einem einzelnen Agent oder Server zugewiesen werden können.

pool-Pool.
Pool, in dem Aufträge in dieser Pipeline ausgeführt werden, sofern nicht anders angegeben.

name Schnur.
Pipelineausführungsnummer.

appendCommitMessageToRunNameBoolescher Wert.
Fügen Sie die Commitnachricht an die Buildnummer an. Der Standardwert ist „true“.

trigger-Trigger aus.
Continuous Integrationstrigger.

parameters-Parametern.
Pipelinevorlagenparameter.

prpr.
Pull Request-Trigger.

schedulesZeitpläne.
Geplante Trigger.

resources-Ressourcen.
Container und Repositorys, die im Build verwendet werden.

variables-Variablen.
Variablen für diese Pipeline.

lockBehavior Schnur.
Verhaltenssperranforderungen aus dieser Phase sollten in Bezug auf andere exklusive Sperranforderungen angezeigt werden. sequenziell | runLatest.

Beispiele

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

Pipeline mit Schritten und einem impliziten Auftrag.

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.

Eigenschaften

steps-Schritte ausführen. Erforderlich.
Eine Liste der Schritte, die in diesem Auftrag ausgeführt werden sollen.

strategyjobs.job.strategy.
Ausführungsstrategie für diesen Auftrag.

continueOnError Schnur.
Die Ausführung auch bei Einem Fehler fortsetzen?

pool-Pool.
Pool, in dem Aufträge in dieser Pipeline ausgeführt werden, sofern nicht anders angegeben.

containerjobs.job.container.
Name der Containerressource.

services Zeichenfolgenwörterbuch.
Containerressourcen, die als Dienstcontainer ausgeführt werden sollen.

workspace-Arbeitsbereich.
Arbeitsbereichsoptionen auf dem Agent.

name Schnur.
Pipelineausführungsnummer.

appendCommitMessageToRunNameBoolescher Wert.
Fügen Sie die Commitnachricht an die Buildnummer an. Der Standardwert ist „true“.

trigger-Trigger aus.
Continuous Integrationstrigger.

parameters-Parametern.
Pipelinevorlagenparameter.

prpr.
Pull Request-Trigger.

schedulesZeitpläne.
Geplante Trigger.

resources-Ressourcen.
Container und Repositorys, die im Build verwendet werden.

variables-Variablen.
Variablen für diese Pipeline.

lockBehavior Schnur.
Verhaltenssperranforderungen aus dieser Phase sollten in Bezug auf andere exklusive Sperranforderungen angezeigt werden. sequenziell | runLatest.

Beispiele

trigger:
- main

pool: 
  vmImage: ubuntu-latest

steps:
- script: "Hello world!"

Weitere Informationen

• Pipelines mit mehreren Aufträgen
• Trigger
• Variablen
• Buildnummernformate