Environment Variables

Environment Variables (переменные окружения) — это параметры конфигурации, которые передаются вашему приложению при сборке и выполнении.

Для чего используются

• API ключи — ключи внешних сервисов
• URL баз данных — подключение к базе данных
• Секреты — токены, пароли
• Конфигурация — настройки приложения

Уровни переменных

ONREZA поддерживает переменные на двух уровнях:

Project Variables

Переменные, специфичные для одного проекта.

• Доступны только в этом проекте
• Можно привязать к определённым окружениям
• Настраиваются в Project → Settings → Environment Variables

Workspace Variables

Переменные, общие для всех проектов в workspace.

• Доступны во всех проектах (или выбранных)
• Удобно для общих API ключей
• Настраиваются в Workspace → Settings → Environment Variables

Совет

Используйте Workspace Variables для переменных, которые одинаковы во всех проектах (например, общий API ключ для аналитики).

Разделы

Project Variables Переменные на уровне проекта

Workspace Variables Общие переменные для всех проектов

Приоритет переменных

При конфликте имён используется следующий приоритет:

1. Project Variable — высший приоритет
2. Linked Workspace Variable — если нет project variable
3. System Variable — если нет пользовательских

Деплой использует:
  DATABASE_URL=... (из Project)
  API_KEY=...      (из Workspace, т.к. нет в Project)
  ONREZA=1         (System)

Scopes (Области применения)

Переменные можно применять к определённым окружениям:

Scope	Описание
All Environments	Применяется везде
Selected	Только к выбранным окружениям

Примеры

DATABASE_URL (Production)   = postgres://prod-db...
DATABASE_URL (Preview)      = postgres://staging-db...

Заметка

Одна переменная может иметь разные значения для разных окружений.

Секреты

Переменные можно пометить как секреты:

• Зашифрованы в базе данных
• Скрыты в UI (показываются как ••••••)
• Требуют подтверждения для просмотра

Осторожно

Даже секретные переменные доступны вашему коду при выполнении. Не логируйте их и не отправляйте в публичные API.

Системные переменные

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

Переменная	Описание	Пример
ONREZA_ENV	Тип окружения	production / preview / development / custom
ONREZA_PROTECTION_BYPASS	Секрет для обхода защиты preview	(если настроен)

Отключение системных переменных

Если системные переменные конфликтуют с вашим кодом:

Project → Settings → Environment Variables → снимите галочку внизу страницы

Импорт и экспорт

Импорт из файла

Загрузите .env файл для быстрого создания переменных:

1. Откройте Environment Variables
2. Нажмите Import
3. Выберите .env файл
4. Подтвердите импорт

Совет

ONREZA автоматически определяет секреты по ключевым словам: KEY, SECRET, TOKEN, PASSWORD, PRIVATE, CERT, CREDENTIALS.

Экспорт

Скачайте все переменные в формате .env:

1. Откройте Environment Variables
2. Нажмите Export
3. Файл скачается автоматически

Best Practices

Именование

# Хорошо
DATABASE_URL=...
STRIPE_SECRET_KEY=...
NEXT_PUBLIC_API_URL=...

# Плохо
db=...
key=...
url=...

Разделение окружений

# Production
DATABASE_URL=postgres://prod-server/db

# Preview
DATABASE_URL=postgres://staging-server/db

Безопасность

• Никогда не храните секреты в коде
• Используйте разные значения для production и preview
• Периодически ротируйте токены и ключи

См. также

• Окружения — Production, Preview, Custom
• Build Settings — настройки сборки
• Деплои — развёртывание