Деплои

Деплой (deployment) — это конкретная версия вашего приложения, развёрнутая на ONREZA. Каждый деплой имеет уникальный URL и может быть в одном из нескольких статусов.

Типы деплоев

Production Deployment

Деплой из основной ветки (обычно main или master). Доступен по production URL проекта.

• Только один активный production деплой в любой момент
• Новый деплой автоматически заменяет предыдущий
• Доступен по production alias: project-workspace.onreza.app

Preview Deployment

Деплой из любой другой ветки или merge request. Используется для тестирования изменений.

• Каждая ветка может иметь активный preview деплой
• Уникальный URL для каждого деплоя
• Идеально для code review

Совет

Preview деплои позволяют тестировать изменения до мержа в main. Поделитесь ссылкой с командой для ревью.

Жизненный цикл деплоя

PENDING → QUEUED → BUILDING → UPLOADING → READY_TO_DEPLOY → DEPLOYING → SMOKE_TESTING → LIVE
                       ↓         ↓              ↓              ↓              ↓
                    FAILED    FAILED         FAILED         FAILED         FAILED

Статусы

Статус	Описание
Pending	Деплой создан, ожидает обработки
Queued	В очереди на сборку
Building	Builder собирает приложение
Uploading	Загрузка артефакта в хранилище (CLI deploy flow)
Ready to Deploy	Артефакт готов, ожидает развёртывания
Deploying	Publisher разворачивает приложение
Smoke Testing	Автоматическая проверка работоспособности
Live	Деплой активен и обслуживает трафик
Stopped	Остановлен (заменён новым или вручную)
Failed	Ошибка на одном из этапов
Cancelled	Отменён пользователем
Skipped	Build пропущен по Ignored Build Step

Финальные статусы

• Live — успешный деплой
• Stopped — остановлен
• Failed — ошибка
• Cancelled — отменён
• Skipped — пропущен

URL деплоев

Каждый деплой получает уникальный URL:

Unique URL

Уникальный для каждого деплоя, не меняется:

myproject-abc123-workspace.onreza.app

Production Alias

Для production деплоев, указывает на текущий активный:

myproject-workspace.onreza.app

Branch Alias

Для preview деплоев, указывает на последний деплой ветки:

myproject-git-feature-branch-workspace.onreza.app

Заметка

Branch alias обновляется при каждом новом деплое из этой ветки. Unique URL остаётся неизменным.

Разделы

Логи сборки Просмотр логов в реальном времени

Откат и отмена Откат к предыдущей версии

Preview Protection Защита preview деплоев

Share Links Временные ссылки для публичного доступа

Создание деплоя

Автоматически (webhook)

При настроенном webhook каждый git push создаёт новый деплой:

1. Git провайдер отправляет webhook
2. ONREZA проверяет подлинность
3. Создаётся деплой для соответствующей ветки

→ Настройка webhooks

Вручную через UI

Нажмите Deploy на странице проекта для создания деплоя из текущего состояния ветки:

1. Перейдите в проект
2. Нажмите кнопку Deploy
3. Выберите ветку (опционально)
4. Дождитесь завершения деплоя

Через CLI

nrz deploy

Команда nrz deploy валидирует build output и загружает артефакты на платформу.

Очередь сборки

При большом количестве деплоев они ставятся в очередь:

• Позиция в очереди видна на странице деплоя
• Лимит concurrent builds зависит от плана (1 для Hobby, 3 для Pro)
• Prioritize Production (Pro) — production деплои идут первыми

Retry Policy

При возникновении transient ошибок билд автоматически перезапускается (до 3 попыток):

Тип ошибки	Примеры	Действие
Network errors	Connection timeout, DNS failure	Автоматический retry
HTTP 502/503/504	Bad Gateway, Service Unavailable, Gateway Timeout	Автоматический retry
Build failure	Ошибки в коде или зависимостях	Нет retry (fail сразу)

Совет

Retry механизм применяется только к временным проблемам инфраструктуры. Ошибки в коде приложения или конфигурации не вызывают повторных попыток.

Логи деплоя

Логи доступны через UI в реальном времени:

Просмотр в UI

1. Перейдите в Project → Deployments
2. Выберите нужный деплой
3. Логи отображаются в реальном времени через Server-Sent Events (SSE)

→ Подробнее о логах

Smoke Testing

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

1. Контейнер запустился
2. Приложение отвечает на HTTP запросы
3. Нет критических ошибок

Если проверка не проходит, деплой помечается как Failed.

Blue-Green Deployment

ONREZA использует blue-green стратегию:

1. Новый деплой разворачивается параллельно
2. После успешной проверки трафик переключается
3. Старый деплой останавливается

Это обеспечивает zero-downtime deployments.

Лимиты

Метрика	Hobby	Pro
Concurrent Builds	1	3
Build Minutes/месяц	60	300
Build Timeout	20 мин	20 мин

→ Подробнее о лимитах

См. также

• Проекты — создание и настройка
• Environment Variables — переменные окружения
• Git интеграция — webhooks и автодеплой