Определение триггера

Триггер принудительной отправки указывает, какие ветви вызывают выполнение сборки непрерывной интеграции.

Определения, ссылающиеся на это определение:конвейера , resources.repositories.repository

Реализации

Реализация	Описание
триггер : нет	Отключите триггеры CI.
триггер : строковый список	Список ветвей, которые активируют выполнение.
триггер : пакет, ветви, пути, теги	Полный синтаксис для полного элемента управления.

Замечания

Дополнительные сведения об использовании триггеров с определенным типом репозитория см. в разделе Поддерживаемые репозитории источников.

Конвейеры YAML настраиваются по умолчанию с триггером CI во всех ветвях, если параметр Отключить подразумеваемый триггер CI YAML. Параметр Отключить подразумеваемый триггер CI YAML можно настроить на уровне организации или на уровне проекта. Если параметр Отключить подразумеваемый триггер CI YAML включен, триггеры CI для конвейеров YAML не включены, если конвейер YAML не имеет trigger раздела. Значение по умолчанию для Отключение подразумеваемого триггера CI YAML равно false.

Существует три различных варианта синтаксиса ключевого слова trigger: список ветвей для включения, способ отключения триггеров CI и полного синтаксиса для полного управления.

Если указать предложение exclude без предложения include для branches, tagsили paths, это эквивалентно указанию * в предложении include.

триггер: нет

Отключите триггеры CI.

trigger: none # Disable CI triggers.

строка trigger. Допустимые значения: нет.

Отключите триггеры CI.

Примеры

trigger: none # will disable CI builds entirely

триггер: строковый список

Список ветвей, которые активируют выполнение.

trigger: [ string ] # List of branches that trigger a run.

Типы списков

Тип	Описание
струна	Список ветвей, которые активируют выполнение.

Примеры

trigger:
- main
- develop

триггер: пакет, ветви, пути, теги

Используйте полный синтаксический элемент управления для полного управления триггером CI.

trigger:
  batch: boolean # Whether to batch changes per branch.
  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.
  paths: # File paths to include or exclude for triggering a run.
    include: [ string ] # List of items to include.
    exclude: [ string ] # List of items to exclude.
  tags: # Tag names to include or exclude for triggering a run.
    include: [ string ] # List of items to include.
    exclude: [ string ] # List of items to exclude.

Свойства

batch логические.
, следует ли выполнять пакетные изменения для каждой ветви.

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

paths includeExcludeFilters.
пути к файлу для включения или исключения для активации выполнения.

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

Замечания

Если у вас много участников команды, которые часто отправляют изменения, может потребоваться уменьшить количество запущенных запусков. Если batchtrue, когда конвейер запущен, система ожидает завершения выполнения, а затем запускает еще один запуск со всеми изменениями, которые еще не созданы. По умолчанию batchfalse.

При указании ветви, тега или пути можно использовать точное имя или подстановочный знак. Дополнительные сведения см. в подстановочных знаков.

Важный

не поддерживается в триггерах ресурса репозитория .

Дополнительные сведения см. в разделе Триггеры — триггеры CI и выбор типа репозитория.

# specific branch build with batching
trigger:
  batch: true
  branches:
    include:
    - main

Примеры

trigger:
  batch: true
  branches:
    include:
    - features/*
    exclude:
    - features/experimental/*
  paths:
    exclude:
    - README.md

См. также

Узнайте больше о триггерах и их указании.