Определение pr

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

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

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

Реализация	Описание
pr: none	Отключите триггеры запросов на вытягивание.
pr: список строк	Список ветвей, запускающих выполнение.
pr: autoCancel, ветви, пути, черновики	Полный синтаксис для полного управления.

Комментарии

Если триггер запроса на вытягивание не указан, запросы на вытягивание в любую ветвь активируют сборку.

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

Важно!

Триггеры YAML PR поддерживаются только в GitHub и Bitbucket Cloud. Если вы используете Azure Repos Git, можно настроить политику ветви для проверки сборки, чтобы запустить конвейер сборки для проверки.

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

pr: none

Отключите триггеры запросов на вытягивание.

pr: none # Disable pull request triggers.

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

Отключите триггеры запросов на вытягивание.

Примеры

Синтаксис отключения:

pr: none # will disable PR builds (but not CI builds)

pr: список строк

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

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

Типы списков

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

Комментарии

Синтаксис списка задает список ветвей, запускающих выполнение при вызове запроса на вытягивание или отправке в исходную ветвь инициированного запроса на вытягивание.

Примеры

Синтаксис списка:

pr:
- main
- develop

pr: autoCancel, ветви, пути, черновики

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

pr:
  autoCancel: boolean # Whether to cancel running PR builds when a new commit lands in the branch. Default: true.
  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.
  drafts: boolean # Whether to start a run when a draft PR is created. Default: true.

Свойства

autoCancelлогическое значение.
Следует ли отменять выполняемые сборки запроса на вытягивание, когда новая фиксация попадает в ветвь. Значение по умолчанию — true.

branchesincludeExcludeFilters.
Имена ветвей, включаемые или исключаемые для запуска запуска.

pathsincludeExcludeFilters.
Пути к файлам, включаемые или исключаемые для запуска выполнения.

draftsлогическое значение.
Указывает, следует ли запускать выполнение при создании черновика запроса на вытягивание. Значение по умолчанию — true.

Примеры

Полный синтаксис:

pr:
  branches:
    include:
    - features/*
    exclude:
    - features/experimental/*
  paths:
    exclude:
    - README.md

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

Узнайте больше о триггерах запросов на вытягивание и их указании.