Git интеграция

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

Заметка

Git интеграция опциональна. Проекты, созданные через CLI (nrz init), работают без Git репозитория — деплой выполняется через nrz deploy. Привязать Git можно в любой момент через Project → Settings → Git или nrz link.

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

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

Заметка

GitLab и Bitbucket напрямую не поддерживаются. Вы можете импортировать репозитории с этих платформ.

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

Разделы

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

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

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

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

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

1. Откройте Account → Settings → Authentication
2. В секции GitHub нажмите Подключить в строке «Вход»
3. Пройдите OAuth авторизацию
4. Нажмите Install GitHub App и выберите репозитории

GitVerse и SourceCraft (BETA)

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

GitVerse:

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

SourceCraft:

1. Откройте SourceCraft → Settings → Access Tokens
2. Создайте токен с правами на чтение репозиториев
3. При подключении укажите slug организации

Совет

Вы можете подключить несколько провайдеров одновременно и выбирать нужный при создании проекта.

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

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

1. Вы делаете git push
2. Git провайдер отправляет webhook в ONREZA
3. ONREZA создаёт новый деплой
4. (Опционально) 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 репозитория:

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

Заметка

Импортированные репозитории форкаются в выбранный Git аккаунт для настройки webhooks. Изменения в оригинале не синхронизируются автоматически.

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

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

• Ссылка на preview deployment
• Статус деплоя
• Скриншот (если включён smoke testing)

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

Заметка

Для GitHub комментарии оставляются через GitHub App. Для GitVerse временно недоступны из-за ограничений API.

Troubleshooting

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

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

”Repository not found”

1. Проверьте что токен действителен
2. Проверьте права токена
3. Переподключите провайдер в настройках

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

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

См. также

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