определение конвейера

Конвейер — это один или несколько этапов, описывающих процесс CI/CD.

Варианты реализации решения

Реализация	Описание
конвейер: этапы	Конвейер с этапами.
pipeline: extends	Конвейер, расширяющий шаблон.
pipeline: jobs	Конвейер с заданиями и одним неявным этапом.
Pipeline: шаги	Конвейер с шагами и одним неявным заданием.

Комментарии

Конвейер — это один или несколько этапов, описывающих процесс CI/CD. Этапы — это основные подразделения в конвейере. Хорошими примерами являются этапы «Создать это приложение», «Выполнить эти тесты» и «Развернуть в тестовой среде».

Этап состоит из одного или нескольких заданий, которые являются единицами работы, назначаемыми одному и тому же компьютеру. Как этапы, так и задания можно размещать в графах зависимостей. Например, «Выполнить этот этап перед тем» и «Это задание зависит от выходных данных вон того задания».

Задание — это линейная последовательность шагов. Шаги могут быть задачами, сценариями или ссылками на внешние шаблоны.

Эта иерархия отражена в структуре файла YAML, например:

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

Для простых конвейеров не требуются все эти уровни. Например, в сборке с одним заданием можно опустить контейнеры для этапов и заданий, так как существуют только шаги. Так как многие параметры, показанные в этой статье, не являются обязательными и имеют хорошие значения по умолчанию, определения YAML вряд ли будут включать их все.

Если у вас есть один этап, можно опустить stages ключевое слово и напрямую указать задания ключевое слово:

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

Если у вас есть один этап и одно задание, можно опустить stages ключевые слова и и jobs напрямую указать шаги ключевое слово:

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

Используйте свойство , name чтобы настроить номер запуска конвейера. Дополнительные сведения см. в разделе Настройка номеров запуска или сборки.

конвейер: этапы

Конвейер с этапами.

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.

Свойства

stagesэтапы. Обязательный.
Этапы — это группы заданий, которые могут выполняться без вмешательства человека.

poolпул.
Пул, в котором будут выполняться задания в этом конвейере, если не указано иное.

name Строка.
Номер выполнения конвейера.

appendCommitMessageToRunNameлогическое значение.
Добавьте сообщение фиксации к номеру сборки. Значение по умолчанию — true.

triggerтриггер.
Триггеры непрерывной интеграции.

parametersпараметры.
Параметры шаблона конвейера.

prпр.
Триггеры запросов на вытягивание.

schedulesрасписания.
Запланированные триггеры.

resourcesресурсы.
Контейнеры и репозитории, используемые в сборке.

variablesпеременные.
Переменные для этого конвейера.

lockBehavior Строка.
Запросы блокировки поведения на этом этапе должны демонстрироваться по отношению к другим монопольным запросам на блокировку. последовательный | runLatest.

Примеры

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"

конвейер: расширяет

Конвейер, расширяющий шаблон.

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.

Свойства

extendsрасширяется. Обязательный.
Расширяет шаблон.

poolпул.
Пул, в котором будут выполняться задания в этом конвейере, если не указано иное.

name Строка.
Номер выполнения конвейера.

appendCommitMessageToRunNameлогическое значение.
Добавьте сообщение фиксации к номеру сборки. Значение по умолчанию — true.

triggerтриггер.
Триггеры непрерывной интеграции.

parametersпараметры.
Параметры шаблона конвейера.

prпр.
Триггеры запроса на вытягивание.

schedulesрасписания.
Запланированные триггеры.

resourcesресурсы.
Контейнеры и репозитории, используемые в сборке.

variablesпеременные.
Переменные для этого конвейера.

lockBehavior Строка.
Запросы на блокировку поведения на этом этапе должны демонстрироваться по отношению к другим запросам на монопольную блокировку. последовательный | runLatest.

конвейер: задания

Конвейер с заданиями и одним неявным этапом.

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.

Свойства

jobsзадания. Обязательный.
Задания представляют собой единицы работы, которые могут быть назначены одному агенту или серверу.

poolпул.
Пул, в котором будут выполняться задания в этом конвейере, если не указано иное.

name Строка.
Номер выполнения конвейера.

appendCommitMessageToRunNameлогическое значение.
Добавьте сообщение фиксации к номеру сборки. Значение по умолчанию — true.

triggerтриггер.
Триггеры непрерывной интеграции.

parametersпараметры.
Параметры шаблона конвейера.

prпр.
Триггеры запроса на вытягивание.

schedulesрасписания.
Запланированные триггеры.

resourcesресурсы.
Контейнеры и репозитории, используемые в сборке.

variablesпеременные.
Переменные для этого конвейера.

lockBehavior Строка.
Запросы на блокировку поведения на этом этапе должны демонстрироваться по отношению к другим запросам на монопольную блокировку. последовательный | runLatest.

Примеры

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: шаги

Конвейер с шагами и одним неявным заданием.

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.

Свойства

stepsшаги. Обязательный.
Список шагов, выполняемых в этом задании.

strategyjobs.job.strategy.
Стратегия выполнения для этого задания.

continueOnError Строка.
Продолжить работу даже при сбое?

poolпул.
Пул, в котором будут выполняться задания в этом конвейере, если не указано иное.

containerjobs.job.container.
Имя ресурса контейнера.

services словарь строк.
Ресурсы контейнера для запуска в качестве контейнера службы.

workspaceрабочая область.
Параметры рабочей области в агенте.

name Строка.
Номер выполнения конвейера.

appendCommitMessageToRunNameлогическое значение.
Добавьте сообщение фиксации к номеру сборки. Значение по умолчанию — true.

triggerтриггер.
Триггеры непрерывной интеграции.

parametersпараметры.
Параметры шаблона конвейера.

prпр.
Триггеры запросов на вытягивание.

schedulesрасписания.
Запланированные триггеры.

resourcesресурсы.
Контейнеры и репозитории, используемые в сборке.

variablesпеременные.
Переменные для этого конвейера.

lockBehavior Строка.
Запросы блокировки поведения на этом этапе должны демонстрироваться по отношению к другим монопольным запросам на блокировку. последовательный | runLatest.

Примеры

trigger:
- main

pool: 
  vmImage: ubuntu-latest

steps:
- script: "Hello world!"

См. также раздел

• Конвейеры с несколькими заданиями
• Триггеры
• Переменные
• Форматы чисел сборки