Часто задаваемые вопросы
Что такое GitRiver?
GitRiver - self-hosted git-платформа на Rust. Один бинарник (~50 МБ) объединяет 16 модулей: Git-хостинг, CI/CD, реестр контейнеров, реестр пакетов (6 форматов), задачи с Kanban, пулл-реквесты, GitOps-деплой (RiverCD), безопасность, 8 каналов уведомлений и другие - при потреблении ~100 МБ RAM.
GitRiver бесплатный?
Да, Community-версия полностью бесплатна без ограничений по количеству пользователей, репозиториев, CI-пайплайнов, реестра пакетов и контейнеров. В Community входят также GitOps-деплой (RiverCD), очередь слияния, бэкапы, 8 каналов уведомлений и защита веток. Pro-версия добавляет единый вход (SAML/SCIM), настраиваемые роли, DORA-метрики, сканирование уязвимостей, проверку лицензий зависимостей, журнал аудита и IP-ограничения.
Какие системные требования?
Сам GitRiver: 1 vCPU, 256 МБ RAM (~100 МБ в покое), PostgreSQL 16+. С CI-раннером на том же хосте: 2+ CPU, 4+ ГБ RAM, Docker 20.10+. Для продакшена с активным CI: 8+ CPU, 16+ ГБ RAM, 100+ ГБ SSD.
Как установить GitRiver?
Самый быстрый способ - Docker Compose: клонируйте репозиторий и выполните docker compose up -d. При первом запуске откроется мастер настройки (http://localhost:3000), где вы создадите администратора. Миграции БД применяются автоматически.
Какой формат CI/CD у GitRiver?
GitRiver использует собственный YAML-формат для CI/CD-пайплайнов. Конфигурация размещается в .gitriver/workflows/ и поддерживает jobs, needs (DAG), правила, артефакты, кеш, сервисные контейнеры, матрицу сборок, повторы и запланированные пайплайны.
Можно ли импортировать существующие репозитории?
Да, GitRiver поддерживает импорт репозиториев из внешних сервисов и по произвольному URL. Задачи, пулл-реквесты, релизы, метки и вехи импортируются. Также поддерживается зеркалирование (pull и push) с настраиваемым интервалом.
Нужен ли интернет для работы?
Нет. GitRiver полностью self-hosted и работает автономно. Pro-лицензия также работает офлайн после однократной активации по схеме «запрос - ответ» (Ed25519).
Что такое Pro-места?
Модель лицензирования GitRiver - за инстанс с Pro-местами. Пользователи регистрируются свободно. Админ назначает Pro-место конкретным пользователям, которым нужны Pro-функции. Лицензии суммируются: две лицензии по 25 мест = 50 мест. Количество мест зависит от тарифа.
Что такое RiverCD?
RiverCD - встроенный GitOps-контроллер для деплоя в Kubernetes. Поддерживает Deployment, StatefulSet, DaemonSet, Job, CronJob, CRD. Волны синхронизации, обнаружение расхождений, канареечный и сине-зелёный деплой, проверки здоровья, логи подов из интерфейса, мультикластер. Не требует внешних инструментов.
Как получить поддержку?
Community: документация, FAQ и GitHub Issues. Pro: приоритетная техподдержка по email и через тикет-систему в личном кабинете с гарантированным временем ответа.