Git интеграция

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

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

Провайдер	Подключение	Особенности
GitHub	GitHub App (OAuth)	Webhooks, вход через GitHub
GitVerse	OAuth2 (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 и выберите репозитории

Доступ ONREZA ограничен репозиториями, разрешёнными в установке GitHub App. Доступ ко всем репозиториям аккаунта не требуется.

GitVerse и SourceCraft (BETA)

GitVerse подключается через OAuth2. Для SourceCraft по-прежнему требуется ручное создание Personal Access Token.

GitVerse:

В ONREZA откройте Workspace → Settings → Git
В карточке GitVerse нажмите Подключить через OAuth2
Подтвердите доступ на стороне 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 или Custom с включённым Auto Deploy и совпадающим шаблоном ветки
Merge Request	Деплой в явно настроенное окружение

Если подходящего окружения нет, push не создаёт деплой. Пустой шаблон Preview не включает все остальные ветки. Для ветки preview задайте Equals → preview в настройках окружения; новые тестовые цели создавайте как Custom.

→ Настройка Webhooks

Deploy Hooks

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

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

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

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

Подключение существующего репозитория и импорт по URL описаны в разделе Создание проекта. Там же указано, как определяется ветка первого развёртывания.

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