Начало работы

Это руководство поможет создать первый проект и развернуть его на платформе.

Требования

• GitHub, GitVerse или SourceCraft аккаунт
• Node.js 18+ и пакетный менеджер (bun, pnpm или npm)
• Один из поддерживаемых фреймворков

Шаг 1: Регистрация

1. Перейди на app.onreza.ru
2. Войди через GitHub, GitVerse или SourceCraft
3. При первом входе автоматически создаётся персональный workspace

Шаг 2: Установка CLI

Quick Install

curl -fsSL https://raw.githubusercontent.com/ONREZA/nrz-cli/main/install.sh | bash

npm/bun

npm i -g @onreza/nrz
# или
bun i -g @onreza/nrz

Проверь установку:

nrz --version

Шаг 3: Аутентификация

nrz login

Команда откроет браузер, где нужно подтвердить вход. После подтверждения токен сохранится автоматически.

Совет

Для CI/CD используй переменную окружения NRZ_TOKEN или флаг --token вместо nrz login.

Шаг 4: Деплой

nrz deploy

nrz-cli автоматически определяет фреймворк, собирает проект и загружает артефакты на платформу. Дополнительных адаптеров или пресетов устанавливать не нужно.

Совет

Сначала выбери контекст через nrz context use production либо передай nrz deploy --environment production. Конкретную ветку можно указать через nrz deploy --branch main.

Шаг 5: Просмотр результата

После успешного деплоя CLI выведет URL:

Deployment complete!

Production:    https://my-project-workspace.onreza.app
Unique:        https://my-project-abc123-workspace.onreza.app

Открой URL в браузере — твоё приложение уже в сети!

Локальная разработка с эмулятором

nrz dev запускает dev-сервер с эмуляцией платформенных API:

nrz dev

Эмулятор предоставляет тот же Functions-style контекст, что и production: ctx.env, ctx.kv, ctx.log и request metadata.

export default {
  async fetch(_request, ctx) {
    const value = await ctx.kv.get("hello");
    return Response.json({
      configured: Boolean(ctx.env.API_URL),
      hasValue: value !== null,
    });
  },
};

Что дальше?

Git интеграцияНастрой автодеплой при пуше

Environment VariablesДобавь секреты и конфигурацию

Custom DomainПодключи свой домен

KV StoreКэш, сессии, rate limiting

Troubleshooting

“Command not found: nrz”

Убедись что глобальные пакеты установлены в PATH:

# Проверь путь
which nrz

# Если не найден, добавь в .zshrc или .bashrc
export PATH="$HOME/.bun/bin:$PATH"

“Build failed”

1. Проверь что используешь поддерживаемый фреймворк (Next.js, Astro, Nuxt, SvelteKit, Remix)
2. Убедись что в проекте есть корректный package.json с командой build
3. Посмотри логи: nrz logs --deployment <id>