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. System Variable — высший приоритет (перезаписывает пользовательские)
2. Project Variable — перезаписывает workspace-переменные
3. Linked Workspace Variable — базовый уровень

Деплой использует:
  ONREZA_ENV=production  (System — перезаписывает одноимённые)
  DATABASE_URL=...       (из Project)
  API_KEY=...            (из Workspace, т.к. нет в Project)

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

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

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

Примеры

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

Заметка

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

Секреты

Переменные можно пометить как секреты. Секреты устроены по write-only модели:

• Зашифрованы в базе данных
• Скрыты в UI: значение не отображается после создания (только метка «секрет»)
• Недоступны через API в явном виде — прочитать plaintext секрета извне нельзя ни через UI, ни через CLI, ни через API
• Доступны вашему коду при сборке и выполнении через обычные переменные окружения

Это защищает от кражи значений через скомпрометированную сессию или токен с правом чтения: даже злоумышленник с доступом к workspace не сможет извлечь секрет обратно. Если значение нужно обновить — перезапишите переменную; старое значение при этом уходит без возможности восстановления.

Осторожно

Секреты доступны вашему коду при выполнении через process.env (или аналог). Не логируйте их и не отправляйте в публичные API.

Совет

Если вы забыли значение секрета — его нельзя «подсмотреть» через платформу. Храните секреты в менеджере паролей или CI vault, а в ONREZA используйте как целевой адресат.

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

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

Переменная	Описание	Пример
ONREZA_ENV	Тип окружения	production / preview / development
ONREZA_PROJECT_NAME	Имя проекта	my-app
ONREZA_GIT_BRANCH	Ветка деплоя	main, feature/auth
ONREZA_GIT_COMMIT_SHA	SHA коммита	a1b2c3d4e5f6...
ONREZA_GIT_COMMIT_MESSAGE	Сообщение коммита	fix: resolve login bug
ONREZA_GIT_PROVIDER	Git-провайдер	github / gitverse / sourcecraft
ONREZA_GIT_REPO_SLUG	Репозиторий	my-org/my-app
ONREZA_PROTECTION_BYPASS	Секрет для обхода защиты preview	(только если настроен)

Заметка

Git-переменные (ONREZA_GIT_*) доступны при деплое через Git (push, merge request, deploy hook). При деплое через CLI доступны ONREZA_PROJECT_NAME и ONREZA_GIT_COMMIT_SHA.

Использование в коде

// Условная логика в зависимости от окружения
if (process.env.ONREZA_ENV === 'preview') {
  console.log('Это preview-деплой');
}

// Информация о коммите для мониторинга
const release = process.env.ONREZA_GIT_COMMIT_SHA;

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

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

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. Файл скачается автоматически

Заметка

Экспорт включает только plain-переменные. Секреты попадают в файл как комментарии-placeholder (имя без значения) — вставить plaintext секрета в экспорт нельзя по дизайну write-only модели. Итоговый .env также содержит строку с количеством пропущенных секретов.

Ограничения

Параметр	Hobby	Pro	Enterprise
Переменных на проект	100	300	1 000
Общий размер на проект	32 КБ	64 КБ	256 КБ

Общий размер считается по сумме всех значений переменных проекта. При превышении лимита операция будет отклонена с сообщением об ошибке.

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 — настройки сборки
• Деплои — развёртывание