définition de pipeline

Un pipeline comprend une ou plusieurs phases qui décrivent un processus CI/CD.

Implémentations

Implémentation	Description
pipeline : phases	Pipeline avec étapes.
pipeline : étend	Pipeline qui étend un modèle.
pipeline : travaux	Pipeline avec des travaux et une étape implicite.
pipeline : étapes	Pipeline avec des étapes et un travail implicite.

Remarques

Un pipeline comprend une ou plusieurs phases qui décrivent un processus CI/CD. Les phases sont les principales divisions d’un pipeline. Les phases « Créer cette application », « Exécuter ces tests » et « Déployer en préproduction » sont de bons exemples.

Une phase correspond à un ou plusieurs travaux, qui sont des unités de travail pouvant être affectées à la même machine. Vous pouvez organiser les phases et les travaux en graphes des dépendances. Citons, par exemple, « Exécuter cette phase avant celle-ci » et « Ce travail dépend de la sortie de ce travail ».

Un travail est une série linéaire d’étapes. Les étapes peuvent être des tâches, des scripts ou des références à des modèles externes.

Cette hiérarchie est reflétée dans la structure d’un fichier YAML comme ceci :

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

Les pipelines simples ne nécessitent pas tous ces niveaux. Par exemple, dans une build à travail unique, vous pouvez omettre les conteneurs pour les étapes et les travaux, car il n’y a que des étapes. Et étant donné que de nombreuses options présentées dans cet article ne sont pas requises et qu’elles ont de bonnes valeurs par défaut, il est peu probable que vos définitions YAML les incluent toutes.

Si vous avez une seule étape, vous pouvez omettre la stages mot clé et spécifier directement les travaux mot clé :

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

Si vous avez une seule étape et un seul travail, vous pouvez omettre les stages mots clés et jobs et spécifier directement les étapes mot clé :

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

Utilisez la name propriété pour configurer le numéro d’exécution du pipeline. Pour plus d’informations, consultez Configurer des numéros d’exécution ou de build.

pipeline : phases

Pipeline avec étapes.

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.

Propriétés

stagesphases. Obligatoire.
Les phases sont des groupes de travaux qui peuvent s’exécuter sans intervention humaine.

poolpool.
Pool dans lequel les travaux de ce pipeline s’exécuteront, sauf indication contraire.

name String.
Numéro d’exécution du pipeline.

appendCommitMessageToRunNamebooléen.
Ajoutez le message de validation au numéro de build. La valeur par défaut est true.

triggerdéclencheur.
Déclencheurs d’intégration continue.

parametersparamètres.
Paramètres de modèle de pipeline.

prpr.
Déclencheurs de demande de tirage.

schedulesplanifications.
Déclencheurs planifiés.

resourcesressources.
Conteneurs et référentiels utilisés dans la build.

variablesvariables.
Variables pour ce pipeline.

lockBehavior String.
Les demandes de verrouillage de comportement de cette étape doivent s’afficher par rapport à d’autres demandes de verrouillage exclusif. séquentiel | runLatest.

Exemples

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 : étend

Pipeline qui étend un modèle.

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.

Propriétés

extendss’étend. Obligatoire.
Étend un modèle.

poolpool.
Pool dans lequel les travaux de ce pipeline s’exécuteront, sauf indication contraire.

name String.
Numéro d’exécution du pipeline.

appendCommitMessageToRunNamebooléen.
Ajoutez le message de validation au numéro de build. La valeur par défaut est true.

triggerdéclencheur.
Déclencheurs d’intégration continue.

parametersparamètres.
Paramètres de modèle de pipeline.

prpr.
Déclencheurs de demande de tirage.

schedulesplanifications.
Déclencheurs planifiés.

resourcesressources.
Conteneurs et référentiels utilisés dans la build.

variablesvariables.
Variables pour ce pipeline.

lockBehavior String.
Les demandes de verrouillage de comportement de cette étape doivent s’afficher par rapport à d’autres demandes de verrouillage exclusif. séquentiel | runLatest.

pipeline : travaux

Pipeline avec des travaux et une étape implicite.

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.

Propriétés

jobstravaux. Obligatoire.
Les travaux représentent des unités de travail qui peuvent être affectées à un seul agent ou serveur.

poolpool.
Pool dans lequel les travaux de ce pipeline s’exécuteront, sauf indication contraire.

name String.
Numéro d’exécution du pipeline.

appendCommitMessageToRunNamebooléen.
Ajoutez le message de validation au numéro de build. La valeur par défaut est true.

triggerdéclencheur.
Déclencheurs d’intégration continue.

parametersparamètres.
Paramètres du modèle de pipeline.

prpr.
Déclencheurs de demande de tirage.

schedulesplanifications.
Déclencheurs planifiés.

resourcesressources.
Conteneurs et référentiels utilisés dans la build.

variablesvariables.
Variables pour ce pipeline.

lockBehavior String.
Les demandes de verrou de comportement de cette étape doivent s’afficher par rapport à d’autres demandes de verrouillage exclusif. séquentiel | runLatest.

Exemples

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 : étapes

Pipeline avec des étapes et un travail implicite.

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.

Propriétés

stepsétapes. Obligatoire.
Liste des étapes à exécuter dans ce travail.

strategyjobs.job.strategy.
Stratégie d’exécution pour ce travail.

continueOnError String.
Continuez à exécuter même en cas d’échec ?

poolpool.
Pool dans lequel les travaux de ce pipeline s’exécuteront, sauf indication contraire.

containerjobs.job.container.
Nom de la ressource de conteneur.

services dictionnaire de chaînes.
Ressources de conteneur à exécuter en tant que conteneur de service.

workspaceespace de travail.
Options de l’espace de travail sur l’agent.

name String.
Numéro d’exécution du pipeline.

appendCommitMessageToRunNamebooléen.
Ajoutez le message de validation au numéro de build. La valeur par défaut est true.

triggerdéclencheur.
Déclencheurs d’intégration continue.

parametersparamètres.
Paramètres de modèle de pipeline.

prpr.
Déclencheurs de demande de tirage.

schedulesplanifications.
Déclencheurs planifiés.

resourcesressources.
Conteneurs et référentiels utilisés dans la build.

variablesvariables.
Variables pour ce pipeline.

lockBehavior String.
Les demandes de verrouillage de comportement de cette étape doivent s’afficher par rapport à d’autres demandes de verrouillage exclusif. séquentiel | runLatest.

Exemples

trigger:
- main

pool: 
  vmImage: ubuntu-latest

steps:
- script: "Hello world!"

Voir aussi

• Pipelines avec plusieurs travaux
• Déclencheurs
• Variables
• Formats de nombres de build