Рабочие процессы

Получите общий обзор рабочих процессов GitHub Actions, включая триггеры, синтаксис и расширенные функции.

В этой статье

Сведения о рабочих процессах

Рабочий процесс — это настраиваемый автоматизированный процесс, который будет выполнять одно или несколько заданий. Рабочие процессы определяются файлом YAML, возвращенным в репозиторий, и будут выполняться при активации события в репозитории. Либо их можно активировать вручную или по определенному расписанию.

Рабочие процессы определяются в каталоге .github/workflows в репозитории. Репозиторий может иметь несколько рабочих процессов, каждый из которых может выполнять различные задачи, такие как:

  • Создание и тестирование запросов на вытягивание
  • Развертывание приложения при каждом создании выпуска
  • Добавление метки при открытии новой проблемы

Основы рабочих процессов

Рабочий процесс должен содержать следующие основные компоненты.

  1. Одно или несколько событий, которые активируют рабочий процесс.
  2. Одно или несколько заданий, каждое из которых выполняется на компьютере средства выполнения и выполняет серию из одного или нескольких шагов.
  3. Каждый шаг может либо запускать определенный вами сценарий, либо запускать многократно используемое расширение, которое упрощает создание рабочего процесса.

Дополнительные сведения об этих основных компонентах см. в разделе Общие сведения о GitHub Actions.

Схема триггера события Runner 1 для запуска задания 1, которая активирует Runner 2 для запуска задания 2. Каждая из заданий разбивается на несколько шагов.

Триггеры рабочего процесса

Триггеры рабочего процесса — это события, которые приводят к запуску рабочего процесса. Эти события могут быть следующими:

  • События, происходящие в репозитории рабочего процесса
  • События, происходящие за пределами GitHub и активируют repository_dispatch событие на GitHub
  • Запланированное время
  • Руководство

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

Триггеры рабочих процессов определяются с помощью ключа on. Дополнительные сведения см. в разделе Синтаксис рабочего процесса для GitHub Actions.

Чтобы запустить рабочий процесс, выполните следующие действия:

  1. Событие происходит в репозитории. Событие имеет связанную фиксацию SHA и ссылку Git.
  2. GitHub выполняет поиск .github/workflows каталога в корневом каталоге репозитория для файлов рабочих процессов, присутствующих в связанной фиксации SHA или Git ref события.
  3. Запуск рабочего процесса выполняется для всех рабочих процессов со значениями on:, соответствующими событию активации. Для некоторых событий также требуется, чтобы файл рабочего процесса присутствовал в ветви репозитория по умолчанию.

Каждый запуск рабочего процесса будет использовать версию рабочего процесса, которая присутствует в связанной фиксации SHA или ссылке Git события. При запуске рабочего процесса GitHub задает GITHUB_SHA переменные среды (фиксация SHA) и GITHUB_REF (Git ref) в среде запуска. Дополнительные сведения см. в разделе Хранение сведений в переменных.

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

Следующие шаги

Чтобы создать первый рабочий процесс, см . раздел AUTOTITLE.