définition de pipeline

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

Implémentations

Implémentation	Descriptif
pipeline : étapes	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 étapes et un travail implicite.

Remarques

Un pipeline comprend une ou plusieurs phases qui décrivent un processus CI/CD. Les étapes 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 étape est un ou plusieurs travaux, qui sont des unités de travail assignables au même ordinateur. 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 à un seul travail, 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 ont de bonnes valeurs par défaut, vos définitions YAML ne sont pas susceptibles d’inclure toutes ces options.

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

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

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

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

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

pipeline : étapes

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

Propriétés

stages étapes. Obligatoire.
Phases sont des groupes d’emplois qui peuvent s’exécuter sans intervention humaine.

pool piscine.
pool où les travaux de ce pipeline s’exécutent, sauf indication contraire.

chaîne name.
numéro d’exécution du pipeline.

appendCommitMessageToRunName booléen .
Ajouter le message de validation au numéro de build. La valeur par défaut est true.

trigger déclencheur.
déclencheurs d’intégration continue.

parameters paramètres.
paramètres de modèle de pipeline.

pr pr.
déclencheurs de demande d’extraction.

schedules planifications.
déclencheurs planifiés.

resources ressources.
conteneurs et référentiels utilisés dans la build.

variables variables.
Variables pour ce pipeline.

chaîne lockBehavior.
les demandes de verrouillage de comportement de cette étape doivent être exposées par rapport à d’autres demandes de verrouillage exclusives. 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: sequential | runLatest # Behavior lock requests from this stage should exhibit in relation to other exclusive lock requests.

Propriétés

extends étend. Obligatoire.
étend un modèle.

pool piscine.
pool où les travaux de ce pipeline s’exécutent, sauf indication contraire.

chaîne name.
numéro d’exécution du pipeline.

appendCommitMessageToRunName booléen .
Ajouter le message de validation au numéro de build. La valeur par défaut est true.

trigger déclencheur.
déclencheurs d’intégration continue.

parameters paramètres.
paramètres de modèle de pipeline.

pr pr.
déclencheurs de demande d’extraction.

schedules planifications.
déclencheurs planifiés.

resources ressources.
conteneurs et référentiels utilisés dans la build.

variables variables.
Variables pour ce pipeline.

chaîne lockBehavior.
les demandes de verrouillage de comportement de cette étape doivent être exposées par rapport à d’autres demandes de verrouillage exclusives. 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: sequential | runLatest # Behavior lock requests from this stage should exhibit in relation to other exclusive lock requests.

Propriétés

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

pool piscine.
pool où les travaux de ce pipeline s’exécutent, sauf indication contraire.

chaîne name.
numéro d’exécution du pipeline.

appendCommitMessageToRunName booléen .
Ajouter le message de validation au numéro de build. La valeur par défaut est true.

trigger déclencheur.
déclencheurs d’intégration continue.

parameters paramètres.
paramètres de modèle de pipeline.

pr pr.
déclencheurs de demande d’extraction.

schedules planifications.
déclencheurs planifiés.

resources ressources.
conteneurs et référentiels utilisés dans la build.

variables variables.
Variables pour ce pipeline.

chaîne lockBehavior.
les demandes de verrouillage de comportement de cette étape doivent être exposées par rapport à d’autres demandes de verrouillage exclusives. 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 é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: 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.

Propriétés

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

strategy emplois.emploi.stratégie.
stratégie d’exécution pour ce travail.

chaîne continueOnError.
Continuer à s’exécuter même en cas d’échec ?

pool piscine.
pool où les travaux de ce pipeline s’exécutent, sauf indication contraire.

container jobs.job.container .
nom de ressource conteneur.

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

workspace espace de travail.
options d’espace de travail sur l’agent.

Pour plus d’informations sur les espaces de travail, notamment les options propres, consultez la rubrique 'espace de travail dans travaux.

chaîne name.
numéro d’exécution du pipeline.

appendCommitMessageToRunName booléen .
Ajouter le message de validation au numéro de build. La valeur par défaut est true.

trigger déclencheur.
déclencheurs d’intégration continue.

parameters paramètres.
paramètres de modèle de pipeline.

pr pr.
déclencheurs de demande d’extraction.

schedules planifications.
déclencheurs planifiés.

resources ressources.
conteneurs et référentiels utilisés dans la build.

variables variables.
Variables pour ce pipeline.

chaîne lockBehavior.
les demandes de verrouillage de comportement de cette étape doivent être exposées par rapport à d’autres demandes de verrouillage exclusives. 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 numéros de build