Что такое Forgejo Runner?
Forgejo Runner — это CI-раннер для Forgejo Actions. Это лёгкий демон, который подключается к вашему экземпляру Forgejo, забирает задания из очереди рабочих процессов и выполняет их на вашей собственной инфраструктуре — используя Docker, LXC или напрямую на хосте — обеспечивая полностью самостоятельно размещаемый CI/CD-конвейер, совместимый с GitHub Actions.
⚡ Ключевые возможности Forgejo Runner
🔁 Совместимость с Actions
Выполняет рабочие процессы, используя тот же синтаксис и экосистему действий, что и GitHub Actions.
🐳 Гибкое выполнение
Выполняйте задания в контейнерах Docker, LXC или напрямую на хост-машине.
🔐 Самостоятельный хостинг
Держите весь ваш CI/CD полностью на собственной инфраструктуре без зависимости от сторонних сервисов.
⚖️ Масштабируемость
Регистрируйте несколько раннеров с метками для распределения и таргетирования нагрузки.
🎯 Почему Forgejo Runner?
- Владейте своим CI: Запускайте конвейеры на оборудовании, которое вы контролируете
- Экосистема Actions: Повторно используйте существующие определения рабочих процессов в стиле GitHub
- Гибкая изоляция: Docker, LXC или выполнение на хосте — под ваши задачи
- Легковесность: Единый бинарный файл на Go, который просто развернуть
🆕 Основные особенности
- Выполнение заданий: Запускает рабочие процессы Forgejo Actions из очереди
- Метки: Направляйте задания на конкретные раннеры
- Поддержка контейнеров: Изолированные сборки через Docker
- Режим демона: Работает непрерывно как сервис
📦 Установка из deb.griffo.io
Шаг 1: Добавить репозиторий
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt updateinstall -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt updatesudo apt install extrepo
sudo extrepo enable griffo
sudo apt update🆓 Есть вечно бесплатное зеркало. deb-free.griffo.io раздаёт пакеты бесплатно навсегда — без аккаунта, без подписки, не более 2 месяцев позади upstream, исправления безопасности сразу. Сейчас там cliamp, Ghostty, lazydocker, Oh My Posh и Zed; Forgejo Runner среди них нет, поэтому репозиторий выше — единственный способ установить его сегодня; попросите, и его можно добавить.
🧩 О варианте extrepo. extrepo — штатный инструмент Debian для внешних репозиториев: он создаёт файл sources и устанавливает ключ подписи, предварительно сверив его с подписанными метаданными. Этот репозиторий зарегистрирован в нём как griffo, а бесплатное навсегда зеркало — как griffo-free, поэтому в Debian (bookworm, trixie, forky и sid) команды выше и есть вся настройка.
extrepo настраивает только файл sources и ключ — учётные данные подписки по-прежнему прописываются в /etc/apt/auth.conf.d/deb.griffo.io.conf. Ubuntu не поддерживается, так как extrepo публикует метаданные только для выпусков Debian: там используйте команды с sudo или от root.
Шаг 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.griffo.io?
- Официальный Debian: Часто отстаёт на месяцы, не хватает новейших функций
- deb.griffo.io: Последняя версия в течение нескольких часов после релиза
- Ручная установка: Требуется ручная загрузка и настройка PATH
- Наш репозиторий: Готовые к использованию собранные пакеты
- ✅ Новейшие функции: Получайте новейшие функции и улучшения Forgejo Runner немедленно
- ✅ Без ручной настройки: Готовые бинарные файлы устанавливаются и обновляются через apt
- ✅ Автоматические обновления: Пакеты обновляются в течение нескольких часов после релиза апстрима
- ✅ Правильные зависимости: Корректно упаковано со всеми необходимыми библиотеками
- ✅ Мульти-дистрибутив: Работает на Bookworm, Trixie и Sid
- ✅ Лёгкое обслуживание: Простые команды apt для обновлений
📦 Репозиторий сборки пакетов
Пакеты Debian собираются и поддерживаются автоматически в этом репозитории GitHub:
- 📁 forgejo-runner-debian — сборки последних релизов
🔗 Связанные пакеты
Также доступны из deb.griffo.io:
- Forgejo — Самостоятельно размещаемый легковесный программный комбинат
- Garage — S3-совместимое распределённое объектное хранилище
- Headscale — Самостоятельно размещаемый управляющий сервер Tailscale
💝 Поддержать проект
Если этот репозиторий экономит ваше время и усилия, рассмотрите возможность его поддержки!