Pipelinedefinition

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

Ausführungen

Implementierung	BESCHREIBUNG
Pipeline: Stufen	Pipeline mit Stufen.
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.

Bemerkungen

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

Eine Stufe ist eine oder mehrere Aufträge, die Einheiten der Arbeit sind, 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
    - ...

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

Wenn Sie über eine einzelne Stufe verfügen, können Sie das schlüsselwort stages weglassen und die Aufträge direkt Schlüsselwort angeben:

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

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

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

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

Pipeline: Stufen

Pipeline mit Stufen.

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.

Eigenschaften

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

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

name Zeichenfolge.
Pipelinelaufnummer.

appendCommitMessageToRunName booleschen.
Anfügen der Commitnachricht an die Buildnummer. Der Standardwert ist "true".

trigger auslösen.
fortlaufende Integrationsauslöser.

parameters Parameter.
Pipelinevorlagenparameter.

pr Pr.
Pullanforderungstrigger.

schedules Zeitpläne.
geplanten Trigger.

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

variables Variablen.
Variablen für diese Pipeline.

lockBehavior Zeichenfolge.
Verhaltenssperranforderungen aus dieser Phase sollten in Bezug auf andere exklusive Sperranforderungen angezeigt werden. sequenzielle | 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: sequential | runLatest # Behavior lock requests from this stage should exhibit in relation to other exclusive lock requests.

Eigenschaften

extends erweitert. Erforderlich.
Erweitert eine Vorlage.

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

name Zeichenfolge.
Pipelinelaufnummer.

appendCommitMessageToRunName booleschen.
Anfügen der Commitnachricht an die Buildnummer. Der Standardwert ist "true".

trigger auslösen.
fortlaufende Integrationsauslöser.

parameters Parameter.
Pipelinevorlagenparameter.

pr Pr.
Pullanforderungstrigger.

schedules Zeitpläne.
geplanten Trigger.

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

variables Variablen.
Variablen für diese Pipeline.

lockBehavior Zeichenfolge.
Verhaltenssperranforderungen aus dieser Phase sollten in Bezug auf andere exklusive Sperranforderungen angezeigt werden. sequenzielle | 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: sequential | runLatest # 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 Zeichenfolge.
Pipelinelaufnummer.

appendCommitMessageToRunName booleschen.
Anfügen der Commitnachricht an die Buildnummer. Der Standardwert ist "true".

trigger auslösen.
fortlaufende Integrationsauslöser.

parameters Parameter.
Pipelinevorlagenparameter.

pr Pr.
Pullanforderungstrigger.

schedules Zeitpläne.
geplanten Trigger.

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

variables Variablen.
Variablen für diese Pipeline.

lockBehavior Zeichenfolge.
Verhaltenssperranforderungen aus dieser Phase sollten in Bezug auf andere exklusive Sperranforderungen angezeigt werden. sequenzielle | 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: outputs | resources | all # What to clean up before the job runs.
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.

Eigenschaften

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

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

continueOnError Zeichenfolge.
Auch bei Fehlern weiter ausgeführt werden?

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

container jobs.job.container verwenden.
Containerressourcenname.

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

workspace Arbeitsbereich.
Arbeitsbereichsoptionen für den Agent.

Weitere Informationen zu Arbeitsbereichen, einschließlich sauberer Optionen, finden Sie im Arbeitsbereich Thema in Jobs.

name Zeichenfolge.
Pipelinelaufnummer.

appendCommitMessageToRunName booleschen.
Anfügen der Commitnachricht an die Buildnummer. Der Standardwert ist "true".

trigger auslösen.
fortlaufende Integrationsauslöser.

parameters Parameter.
Pipelinevorlagenparameter.

pr Pr.
Pullanforderungstrigger.

schedules Zeitpläne.
geplanten Trigger.

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

variables Variablen.
Variablen für diese Pipeline.

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

Beispiele

trigger:
- main

pool: 
  vmImage: ubuntu-latest

steps:
- script: "Hello world!"

Siehe auch

• Pipelines mit mehreren Aufträgen
• Auslöser
• Variablen
• Buildnummernformate