nektos/act

Что это?

Ключевые возможности

• 01Локально запускает GitHub Actions workflow в контейнерах Docker.
• 02Учитывает зависимости между заданиями, чтобы определить порядок выполнения.
• 03Настраивает переменные окружения и пути файловой системы так, чтобы они соответствовали GitHub runners.
• 04Может служить локальным средством запуска задач на основе существующих файлов workflow.
• 05Есть расширение для VS Code, позволяющее запускать workflow из редактора.

Сценарии использования

• Проверка изменений в файлах `.github/workflows/` перед отправкой в репозиторий.
• Отладка упавшего задания CI без ожидания удалённых runners.
• Замена Makefile переиспользуемыми определениями workflow для локальных задач.

Быстрый старт

1. 1

   Установите Docker и убедитесь, что он запущен

2. 2

   Клонируйте repo и соберите проект из исходного кода с помощью make install (требуется Go 1.20 или новее)

   make install
3. 3

   Запускайте workflows локально из repo, содержащего .github/workflows/

   act

Что важно знать

• !Docker должен быть установлен и запущен.
• !Запуск выполняется в контейнерах, поэтому среда может не полностью соответствовать средам runner’ов, размещённых на GitHub.

Темы

Частые вопросы

Что такое act?

CLI для локального запуска GitHub Actions в Docker — проверяйте изменения, не создавая коммит и не отправляя его в репозиторий. act читает файлы workflow из `.github/workflows/` и запускает задания на вашем компьютере с помощью Docker. Он загружает или собирает необходимые workflow образы, определяет порядок выполнения по зависимостям между заданиями и запускает контейнер для каждого шага. Переменные окружения и структура файловой системы настраиваются так, чтобы соответствовать окружению GitHub-hosted runners.

act можно использовать бесплатно? Какая у него лицензия?

act распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.

act всё ещё поддерживается?

Обновлялся за последние 6 месяцев. Последний коммит в act — 9 авг. 2026 г..

Для чего можно использовать act?

Проверка изменений в файлах `.github/workflows/` перед отправкой в репозиторий. Отладка упавшего задания CI без ожидания удалённых runners. Замена Makefile переиспользуемыми определениями workflow для локальных задач.

Как установить act?

Установите Docker и убедитесь, что он запущен Клонируйте repo и соберите проект из исходного кода с помощью make install (требуется Go 1.20 или новее): make install Запускайте workflows локально из repo, содержащего .github/workflows/: act

Где скачать act?

Исходный код и инструкции по установке — на GitHub: https://github.com/nektos/act