Git интеграция

ONREZA интегрируется с Git провайдерами для автоматического создания деплоев при каждом пуше в репозиторий.

Поддерживаемые провайдеры

Провайдер	Подключение	Особенности
GitHub	GitHub App (OAuth)	Webhooks, вход через GitHub
GitVerse	Personal Access Token (BETA)	Webhooks, Fork, Import
SourceCraft	Personal Access Token (BETA)	Webhooks, Import, PR комментарии

→ Настройка провайдеров

Разделы

Настройка WebhooksАвтоматические деплои при пуше

Deploy HooksВнешние триггеры для деплоев

Подключение провайдера

GitHub (рекомендуется)

GitHub подключается через OAuth и GitHub App — самый простой способ:

Выберите нужный workspace
Если GitHub не привязан как метод входа, откройте Account → Settings → Authentication и привяжите GitHub
Откройте Workspace → Settings → Git
Нажмите Install GitHub App и выберите репозитории

GitVerse и SourceCraft (BETA)

Для GitVerse и SourceCraft требуется ручное создание Personal Access Token.

GitVerse:

Откройте GitVerse → Settings → Tokens
Создайте токен с правами:
- Репозитории: Чтение + Запись
- Организации: Чтение
- Пользователи: Чтение
В ONREZA откройте Workspace → Settings → Git
Вставьте токен в секции GitVerse

SourceCraft:

Откройте SourceCraft → Settings → Access Tokens
Создайте токен с правами на чтение репозиториев
В ONREZA откройте Workspace → Settings → Git
При подключении укажите slug организации

Как работает интеграция

Git Provider                    ONREZA
     │                            │
     │  1. git push               │
     ├──────────────────────────► │
     │                            │
     │  2. Webhook notification   │
     │ ◄────────────────────────── │
     │                            │
     │  3. Create deployment      │
     │                            │
     │  4. MR comment (optional)  │
     │ ◄────────────────────────── │

Вы делаете git push
Git провайдер отправляет webhook в ONREZA
ONREZA создаёт новый деплой
(Опционально) ONREZA оставляет комментарий в MR с ссылкой на preview

Автодеплой

При настроенном webhook ONREZA автоматически создаёт деплои:

Событие	Результат
Push в main	Production deployment
Push в другую ветку	Preview deployment
Merge Request	Preview deployment (если настроено)

→ Настройка Webhooks

Deploy Hooks

Deploy Hooks — это специальные URL для триггера деплоев из внешних систем:

CI/CD пайплайны
Scheduled deployments
Content updates (CMS)

→ Подробнее о Deploy Hooks

Импорт репозитория

ONREZA поддерживает импорт из любого публичного Git репозитория:

На странице создания проекта вставьте URL репозитория
Выберите Git провайдер для форка (GitHub, GitVerse или SourceCraft)
ONREZA создаст форк в выбранном аккаунте
Webhooks настроятся автоматически

PR комментарии

Для GitHub и SourceCraft проектов ONREZA может оставлять комментарии в Pull Requests:

Ссылка на preview deployment
Статус деплоя
Скриншот деплоя

Настройка: Project → Settings → Git → PR Comments

Troubleshooting

Webhook не срабатывает

→ Устранение неполадок Webhooks

“Repository not found”

Проверьте, что workspace Git connection подключён к владельцу нужного репозитория
Для GitHub проверьте, что репозиторий выбран в GitHub App installation
Переподключите провайдер в Workspace → Settings → Git

Деплой не создаётся при пуше

Проверьте что Auto Deploy включён
Проверьте настройки webhook в Git провайдере
Проверьте секрет webhook

См. также

Создание проекта — импорт репозитория
Деплои — типы деплоев
Окружения — Production vs Preview