Что такое Forgejo Runner?
Forgejo Runner — это CI-раннер для Forgejo Actions. Это лёгкий демон, который подключается к вашему экземпляру Forgejo, забирает задания из очереди рабочих процессов и выполняет их на вашей собственной инфраструктуре — используя Docker, LXC или напрямую на хосте — обеспечивая полностью самостоятельно размещаемый CI/CD-конвейер, совместимый с GitHub Actions.
🚀 Почему важны последние версии: Раннер тесно следует релизам Forgejo, добавляя поддержку новых возможностей рабочих процессов, улучшенную изоляцию и исправления ошибок. Поддержание его в актуальном состоянии обеспечивает совместимость с новейшими возможностями Forgejo Actions.
⚡ Ключевые возможности Forgejo Runner
🔁 Совместимость с Actions
Выполняет рабочие процессы, используя тот же синтаксис и экосистему действий, что и GitHub Actions.
🐳 Гибкое выполнение
Выполняйте задания в контейнерах Docker, LXC или напрямую на хост-машине.
🔐 Самостоятельный хостинг
Держите весь ваш CI/CD полностью на собственной инфраструктуре без зависимости от сторонних сервисов.
⚖️ Масштабируемость
Регистрируйте несколько раннеров с метками для распределения и таргетирования нагрузки.
🎯 Почему Forgejo Runner?
- Владейте своим CI: Запускайте конвейеры на оборудовании, которое вы контролируете
- Экосистема Actions: Повторно используйте существующие определения рабочих процессов в стиле GitHub
- Гибкая изоляция: Docker, LXC или выполнение на хосте — под ваши задачи
- Легковесность: Единый бинарный файл на Go, который просто развернуть
🆕 Основные особенности
- Выполнение заданий: Запускает рабочие процессы Forgejo Actions из очереди
- Метки: Направляйте задания на конкретные раннеры
- Поддержка контейнеров: Изолированные сборки через Docker
- Режим демона: Работает непрерывно как сервис
📦 Установка из deb-free.griffo.io
Шаг 1: Добавить репозиторий
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb-free.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb-free.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb-free.griffo.io.gpg] https://deb-free.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb-free.griffo.io.list > /dev/null
sudo apt update
install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb-free.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb-free.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb-free.griffo.io.gpg] https://deb-free.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb-free.griffo.io.list > /dev/null
apt update
Шаг 2: Установить forgejo-runner
# Install latest forgejo-runner
sudo apt install forgejo-runner
# Verify installation
forgejo-runner --version
# Install latest forgejo-runner
apt install forgejo-runner
# Verify installation
forgejo-runner --version
🎯 Примеры базового использования
# Show version
forgejo-runner --version
# Generate a default config file
forgejo-runner generate-config > config.yaml
# Register the runner with your Forgejo instance
forgejo-runner register --instance https://forgejo.example.com --token <TOKEN>
# Start the runner daemon
forgejo-runner daemon
🚀 Почему стоит выбрать deb-free.griffo.io?
📊 Сравнение репозиториев:
- Официальный Debian: Часто отстаёт на месяцы, не хватает новейших функций
- deb.griffo.io (main): Последняя версия в течение нескольких часов после релиза
- Ручная установка: Требуется ручная загрузка и настройка PATH
- Наш репозиторий: Готовые к использованию собранные пакеты
- ✅ Новейшие функции: Получайте новейшие функции и улучшения Forgejo Runner — релиз не старше 2 месяцев
- ✅ Без ручной настройки: Готовые бинарные файлы устанавливаются и обновляются через apt
- ✅ Автоматические обновления: Пакеты обновляются автоматически; в бесплатной линии — не позже 2 месяцев после релиза, исправления безопасности немедленно
- ✅ Правильные зависимости: Корректно упаковано со всеми необходимыми библиотеками
- ✅ Мульти-дистрибутив: Работает на Bookworm, Trixie и Sid
- ✅ Лёгкое обслуживание: Простые команды apt для обновлений
📦 Репозиторий сборки пакетов
Пакеты Debian собираются и поддерживаются автоматически в этом репозитории GitHub:
- 📁 forgejo-runner-debian — сборки последних релизов
🔗 Связанные пакеты
Также доступны из deb.griffo.io:
- Forgejo — Самостоятельно размещаемый легковесный программный комбинат
- Garage — S3-совместимое распределённое объектное хранилище
- Headscale — Самостоятельно размещаемый управляющий сервер Tailscale
🎯 Идеально для: команд и отдельных пользователей, самостоятельно размещающих Forgejo, которые хотят запускать собственные CI/CD-конвейеры с полным контролем над средой сборки и инфраструктурой.
💝 Поддержать проект
Если этот репозиторий экономит ваше время и усилия, рассмотрите возможность его поддержки!