Определение schedules.cron

Запланированный триггер указывает расписание построения ветвей.

schedules:
- cron: string # Required as first property. Cron syntax defining a schedule in UTC time.
  displayName: string # Optional friendly name given to a specific schedule.
  branches: # Branch names to include or exclude for triggering a run.
    include: [ string ] # List of items to include.
    exclude: [ string ] # List of items to exclude.
  batch: boolean # Whether to run the pipeline if the previously scheduled run is in-progress; the default is false.
  always: boolean # Whether to always run the pipeline or only if there have been source code or pipeline settings changes since the last successful scheduled run. The default is false.

schedules:
- cron: string # Required as first property. Cron syntax defining a schedule in UTC time.
  displayName: string # Optional friendly name given to a specific schedule.
  branches: # Branch names to include or exclude for triggering a run.
    include: [ string ] # List of items to include.
    exclude: [ string ] # List of items to exclude.
  always: boolean # Whether to always run the pipeline or only if there have been source code or pipeline settings changes since the last successful scheduled run. The default is false.

Определения, ссылающиеся на это определение: расписания

строка cron. Обязательный в качестве первого свойства.
синтаксис Cron, определяющий расписание в формате UTC.

строка displayName.
понятное имя, заданное определенному расписанию.

branches includeExcludeFilters.
Имена ветвей для включения или исключения для активации выполнения.

batch логические.
Свойство batch настраивает, следует ли запускать конвейер, если ранее запланированное выполнение выполняется. Если batchtrue, новый запуск конвейера не начнется по расписанию, если предыдущий запуск всё ещё выполняется. Значение по умолчанию — false.

Свойство batch зависит от параметра свойства always. Если alwaystrue, запуск производится в соответствии с расписанием cron, даже когда batchtrue и запущен процесс.

always логические.
, следует ли всегда запускать конвейер или только в том случае, если с момента последнего успешного запланированного выполнения произошли изменения исходного кода; Значение по умолчанию — false.

Переменная Build.CronSchedule.DisplayName

При выполнении конвейера вследствие запланированного триггера cron предопределенная переменная Build.CronSchedule.DisplayName содержит displayName расписания cron, инициирует запуск конвейера.

Конвейер YAML может содержать несколько расписаний cron, и может потребоваться, чтобы конвейер выполнял различные этапы или задания на основе которых выполняется расписание cron. Например, у вас есть ночная сборка и еженедельная сборка, и вы хотите запустить определенный этап только во время ночной сборки. Можно использовать переменную Build.CronSchedule.DisplayName в задании или условии этапа, чтобы определить, следует ли выполнять это задание или этап.

- stage: stage1
  # Run this stage only when the pipeline is triggered by the 
  # "Daily midnight build" cron schedule
  condition: eq(variables['Build.CronSchedule.DisplayName'], 'Daily midnight build')

Дополнительные примеры см. в следующем разделе Примеры.

Чтобы условно запустить этап или задание на основе того, было ли оно запланировано запланированным триггером, используйте переменную Build.CronSchedule.DisplayName в условии. В этом примере stage1 выполняется только в том случае, если конвейер был активирован расписанием Daily midnight build, а job3 выполняется только в том случае, если конвейер был активирован расписанием Weekly Sunday build.

stages:
- stage: stage1
  # Run this stage only when the pipeline is triggered by the 
  # "Daily midnight build" cron schedule
  condition: eq(variables['Build.CronSchedule.DisplayName'], 'Daily midnight build')
  jobs:
  - job: job1
    steps:
    - script: echo Hello from Stage 1 Job 1

- stage: stage2
  dependsOn: [] # Indicate this stage does not depend on the previous stage
  jobs:
  - job: job2
    steps:
    - script: echo Hello from Stage 2 Job 2
  - job: job3 
    # Run this job only when the pipeline is triggered by the 
    # "Weekly Sunday build" cron schedule
    condition: eq(variables['Build.CronSchedule.DisplayName'], 'Weekly Sunday build')
    steps:
    - script: echo Hello from Stage 2 Job 3