Rivalry2

HTML Diff

0 added 0 removed

Original 2026-01-01

Modified 2026-02-26

1 GitHub Actions - бесплатная для публичных репозиториев система непрерывной интеграции. Хекслет использует Actions во всех своих закрытых и открытых проектах (<a>пример</a>). С помощью Github Actions можно делать много полезного:

2 <ul><li>Запустить проверку кода линтером и тестами</li>

3 <li>Выполнить деплой проекта</li>

4 <li>Опубликовать новую версию пакета</li>

5 <li>Подключить оповещения в мессенджер о событиях в репозитории (новые issue, PR)</li>

6 <li>и многое другое</li>

7 </ul>В этом уроке мы разберемся в основных концепциях системы, а затем рассмотрим пример настройки, чтобы быстро начать работу с Actions в своем репозитории.

8 Общий принцип работы Github Actions такой: в нужном репозитории создается директория.github/workflows. Внутри нее размещаются файлы с описанием шагов, которые нужно выполнить на различные действия. Данные в файлах хранятся в формате YAML. Ниже описание процесса "show-directory", который запускается на пуш в репозиторий. В этом примере описание процесса хранится в файлеshow-directory.yml. Можно указывать любое имя файла, главное сохранять расширение и чтобы имя соответствовало по смыслу. В терминах Github Actions такое описание процесса называется воркфлоу. В нем определяется, на какие события реагировать и что конкретно делать:

9 Этот воркфлоу просто печатает на экран содержимое текущей директории. Реальные воркфлоу выглядят сложнее, но прямо сейчас нам важно ухватить общую структуру, не отвлекаясь на конкретный процесс. У любой системы непрерывной интеграции есть набор блоков, из которых строится процесс выполнения. Он примерно одинаковый для всех за исключением некоторых деталей. Дальше мы кратко пробежимся по этим блокам, а уже в следующих уроках подробно поговорим про некоторые из них.

10 <h2>Основные понятия</h2>

11 На картинке ниже показаны основные концепции GitHub Actions. Разберем их по порядку.

12 <ul><li>Воркфлоу / Workflows

13 Каждый репозиторий на GitHub может содержать один или несколько воркфлоу. Каждый воркфлоу определяется в отдельном файле конфигурации в каталоге репозитория.github/workflows. Несколько воркфлоу могут выполняться параллельно.

14 </li>

15 <li>События / Events

16 Воркфлоу может запускаться одним или несколькими событиями. Это могут быть внутренние события GitHub (например, пуш, релиз или пул-реквест), запланированные события (запускаются в определенное время - например, cron) или произвольные внешние события (запускаются вызовом Webhook API GitHub).

17 </li>

18 <li>Задания / Jobs

19 Воркфлоу состоит из одного или нескольких заданий. Задание содержит набор команд, которые запускаются вместе с рабочим процессом. По умолчанию при запуске воркфлоу все его задания выполняются параллельно, однако между ними можно определить зависимость, чтобы они выполнялись последовательно.

20 </li>

21 <li>Раннеры / Runners

22 Каждое задание выполняется на определенном раннере - временном сервере на GitHub с выбранной операционной системой (Linux, macOS или Windows). Также существуют<a>автономные раннеры</a>, которые позволяют создать свое окружение для выполнения экшена.

23 </li>

24 <li>Шаги / Steps

25 Задания состоят из последовательности шагов. Шаг - это либо команда оболочки (shell command), либо экшен (action). Все шаги задания выполняются последовательно на раннере, связанном с заданием. По умолчанию в случае сбоя шага все следующие шаги задания пропускаются.

26 </li>

27 <li>Экшен / Actions

28 Экшен - многократно используемый блок кода, который может служить шагом задания. Каждый экшен может принимать на вход параметры и создавать любые значения, которые затем можно использовать в других экшенах. Разработчики могут создавать собственные экшены или использовать опубликованные сообществом GitHub. Общих экшенов около тысячи, все они доступны на<a>GitHub Marketplace</a>.

29 </li>

30 </ul>