Создание проекта

ONREZA предлагает несколько способов создания проекта в зависимости от того, где находится ваш код.

Способ	Описание	Тип проекта
Git аккаунт	Выбор репозитория из подключённого провайдера	Git
Import по URL	Любой публичный Git URL (создаётся форк)	Git
Fork	Форк существующего репозитория	Git
CLI (nrz init)	Создание без Git репозитория	CLI

Из подключённого Git аккаунта

Самый простой способ — выбрать репозиторий из списка подключённых аккаунтов.

1. Откройте страницу создания

   Нажмите New Project на главной странице workspace

2. Выберите Git провайдер

   Если у вас подключено несколько провайдеров (GitHub, GitVerse, SourceCraft), выберите нужный в верхней части страницы

3. Найдите репозиторий

   Используйте поиск или прокрутите список. Репозитории отсортированы по дате последней активности.

4. Нажмите “Import”

   Нажмите кнопку Import рядом с нужным репозиторием

5. Настройте проект

   На странице конфигурации проверьте автоматически определённые настройки и при необходимости измените их

6. Запустите деплой

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

Импорт по URL

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

1. Откройте страницу создания

   Нажмите New Project на главной странице workspace

2. Вставьте URL репозитория

   В поле ввода вверху страницы вставьте URL:

   • https://github.com/user/repo
   • https://gitlab.com/user/repo
   • Или любой другой Git URL

3. Выберите Git провайдер для форка

   Выберите куда создать форк: GitHub, GitVerse или SourceCraft

4. Подтвердите импорт

   ONREZA покажет информацию о репозитории. Нажмите Import для продолжения.

5. Дождитесь форка

   Репозиторий автоматически форкнется в выбранный аккаунт. Это позволит настроить webhooks.

6. Настройте и деплойте

   Проверьте настройки и нажмите Deploy

Заметка

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

Fork репозитория

Если вы хотите начать с существующего проекта как основы:

1. Найдите репозиторий для форка

   На странице создания проекта найдите репозиторий

2. Нажмите “Fork”

   Вместо Import нажмите Fork (иконка ветвления)

3. Выберите имя

   Укажите имя для форка в вашем аккаунте

4. Дождитесь создания

   Форк будет создан в выбранном провайдере и ONREZA автоматически подключит его

Создание через CLI

Для проектов без Git репозитория используйте CLI. Это удобно для быстрого прототипирования или проектов, не привязанных к Git.

1. Авторизуйтесь

   nrz login

2. Инициализируйте проект

   nrz init

   CLI создаст проект в вашем workspace. Фреймворк и настройки сборки будут определены автоматически.

3. Деплойте

   nrz deploy

   Проект будет собран локально, артефакты загружены на платформу.

Совет

CLI-проект можно привязать к Git репозиторию позже через Project → Settings → Git. После привязки проект станет Git-проектом с поддержкой webhooks и автодеплоев.

Конфигурация проекта

После выбора репозитория (или создания через CLI) вы попадёте на страницу конфигурации.

Имя проекта

• Display Name — отображаемое имя проекта
• Slug — URL-friendly имя (используется в URL деплоев)

Совет

Slug должен быть уникальным в рамках workspace и может содержать только буквы, цифры и дефисы.

Фреймворк

ONREZA автоматически определяет фреймворк. Вы можете:

• Оставить автоопределённый фреймворк
• Выбрать другой из списка
• Выбрать “Other” для ручной настройки

→ Подробнее о фреймворках

Build Settings

Настройка	Описание	Пример
Build Command	Команда сборки	npm run build
Output Directory	Папка с результатом	dist, .next, build
Install Command	Установка зависимостей	npm install
Root Directory	Корень проекта (для монорепо)	packages/web

Root Directory

Для монорепозиториев укажите путь к папке с проектом:

my-monorepo/
├── packages/
│   ├── web/          ← Root Directory: packages/web
│   │   ├── package.json
│   │   └── src/
│   └── api/
└── package.json

Заметка

При указании Root Directory, Build Command и Output Directory будут относительны этой папке.

Environment Variables

Добавьте переменные окружения прямо при создании проекта:

1. Разверните секцию Environment Variables

2. Добавьте переменные

   Укажите ключ и значение для каждой переменной

3. Отметьте секреты

   Для чувствительных данных (API ключи, пароли) включите флаг Secret

→ Подробнее о переменных окружения

После создания

После нажатия Deploy:

1. Создаётся проект
2. Автоматически создаются окружения Production и Preview
3. Запускается первый деплой
4. Вы перенаправляетесь на страницу деплоя с real-time логами

Несколько проектов из одного репозитория

ONREZA поддерживает создание нескольких проектов из одного репозитория. Это полезно для:

• Монорепозиториев — разные Root Directory для каждого пакета
• Разных окружений — разные переменные окружения для staging/production
• A/B тестирования — разные настройки сборки

Каждый проект имеет уникальный webhook secret, поэтому деплои триггерятся независимо.

Troubleshooting

”Repository not found”

• Убедитесь, что Git провайдер подключён
• Проверьте, что у токена есть права на чтение репозитория
• Для приватных репозиториев нужны соответствующие права

”Framework not detected”

• Проверьте что package.json находится в корне (или в указанной Root Directory)
• Убедитесь что фреймворк указан в dependencies
• Выберите фреймворк вручную из списка

”Build command not found”

• Проверьте что в package.json есть скрипт build
• Укажите Build Command вручную

См. также

• Фреймворки — поддерживаемые фреймворки
• Build Settings — настройки сборки
• Environment Variables — переменные окружения