Project Variables

Project Variables — переменные окружения, специфичные для одного проекта.

Где найти

Project → Settings → Environment Variables

Создание переменной

1. Откройте настройки проекта

   Перейдите в проект → Settings → Environment Variables

2. Нажмите “Add Variable”

3. Заполните форму

   Поле	Описание
   Key	Имя переменной (UPPER_SNAKE_CASE)
   Value	Значение
   Secret	Зашифровать значение
   Scope	К каким окружениям применить

4. Сохраните

   Нажмите Save

Заметка

Новые переменные применятся при следующем деплое. Для текущего деплоя потребуется редеплой.

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

All Environments

Переменная доступна во всех окружениях (Production, Preview, Custom).

Selected Environments

Переменная доступна только в выбранных окружениях.

Пример использования:

# Production
DATABASE_URL=postgres://prod-db.example.com/app

# Preview (staging)
DATABASE_URL=postgres://staging-db.example.com/app

1. Создайте переменную DATABASE_URL для Production
2. Выберите Scope → Selected → отметьте Production
3. Создайте ещё одну переменную DATABASE_URL для Preview
4. Выберите Scope → Selected → отметьте Preview

Preview Branch Filter

Для Preview окружения можно дополнительно фильтровать по ветке:

# Только для ветки 'staging'
DATABASE_URL (Preview, branch: staging) = postgres://staging-db...

# Для всех остальных preview
DATABASE_URL (Preview) = postgres://dev-db...

Редактирование

1. Найдите переменную в списке
2. Нажмите на неё для открытия формы
3. Измените значение или настройки
4. Нажмите Save

Заметка

Изменения применятся при следующем деплое. Для немедленного применения сделайте редеплой вручную.

Удаление

1. Найдите переменную в списке
2. Нажмите иконку удаления (корзина)
3. Подтвердите удаление

Осторожно

Удаление переменной может сломать приложение, если оно от неё зависит. Убедитесь что переменная не используется.

Секреты

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

При создании переменной включите флаг Secret:

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

Просмотр секрета

1. Найдите переменную в списке
2. Нажмите Reveal (иконка глаза)
3. Значение покажется на несколько секунд

Изменение секрета

Секреты изменяются так же как обычные переменные. При сохранении значение перешифровывается.

Bulk Editor

Для массового редактирования используйте Bulk Editor:

1. Нажмите Bulk Edit
2. Отредактируйте переменные в формате .env:

   KEY1=value1
   KEY2=value2

3. Нажмите Apply

Осторожно

В Bulk Editor секреты показываются открытым текстом. Будьте осторожны.

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

1. Нажмите Import
2. Выберите .env файл
3. Просмотрите распознанные переменные
4. Выберите какие импортировать
5. Нажмите Import

Автоопределение секретов

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

• KEY, SECRET, TOKEN, PASSWORD
• PRIVATE, CERT, CREDENTIALS

Связывание с Workspace Variables

Вы можете использовать переменные из Workspace:

1. Откройте Environment Variables
2. Нажмите Add Variable и выберите вкладку Link Shared
3. Выберите workspace переменные для связывания
4. Нажмите Link

Связанные переменные отображаются в секции Shared Variables ниже основного списка. При изменении в Workspace — значение обновится во всех проектах.

Troubleshooting

Переменная не применилась

1. Проверьте что сделали деплой после изменения
2. Проверьте Scope — переменная может быть не для этого окружения
3. Проверьте что нет конфликта с Project Variable (она имеет приоритет)

Переменная не видна в коде

1. Убедитесь что переменная создана
2. Для frontend (client-side) нужен специальный префикс:
   • Nuxt: NUXT_PUBLIC_
   • Vite: VITE_
   • Astro: переменные доступны через import.meta.env
3. Проверьте что деплой завершился успешно

Значение отличается от ожидаемого

1. Проверьте приоритет: Project > Workspace > System
2. Проверьте что нет разных значений для разных окружений
3. Проверьте Preview Branch Filter

См. также

• Workspace Variables — общие переменные
• Окружения — типы окружений
• Build Settings — системные переменные