Окружения

Окружение (Environment) — это именованная цель деплоя со своими настройками и стабильным адресом. Новая версия приложения обновляет то же окружение; имя Git-ветки само по себе не создаёт окружение или адрес.

Типы окружений

Production

Основное окружение для production версии приложения.

Характеристика	Значение
Ветка	Основная ветка (main, master)
URL	Production alias: project-workspace.onreza.app
Custom Domains	Поддерживаются
Создаётся	Автоматически при создании проекта

Заметка

Production окружение всегда отслеживает основную ветку репозитория. Изменить это нельзя.

Preview

Сохранённое окружение для тестирования изменений до мержа. Чтобы автоматически деплоить ветку в Preview, включите Auto Deploy и задайте явный шаблон ветки, например Equals → preview. Для независимых тестовых версий создайте отдельные Custom окружения.

Характеристика	Значение
Ветки	Явно настроенный паттерн
URL	Стабильный адрес окружения, показанный в панели
Custom Domains	Поддерживаются
Создаётся	Сохранено у существующих проектов; для новых тестовых целей создайте Custom

Development

Сохранённое системное окружение для development scope. Используется для development-переменных и runtime-конфигурации, но не является отдельной веткой автодеплоя.

Характеристика	Значение
Ветки	Не привязано к ветке
URL	Не создаёт отдельный public URL
Custom Domains	Не поддерживаются
Создаётся	Сохранено у существующих проектов

Custom

Пользовательские окружения для специфических сценариев.

Характеристика	Значение
Ветки	Настраиваемый паттерн
URL	Стабильный адрес окружения, показанный в панели
Custom Domains	Поддерживаются
Создаётся	Вручную

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

• Staging — предрелизное тестирование
• QA — окружение для QA команды
• Demo — демо для клиентов

Создание Custom окружения

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

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

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

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

   Поле	Описание
   Name	Название (например, “Staging”)
   Type	Custom
   Branch Pattern	Паттерн ветки
   Match Type	Тип сопоставления

4. Сохраните

Branch Pattern (Паттерн ветки)

Определяет какие ветки относятся к окружению.

Match Types

Тип	Описание	Пример паттерна	Совпадает с
Equals	Точное совпадение	staging	только staging
Starts With	Начинается с	release/	release/1.0, release/2.0
Ends With	Заканчивается на	-prod	feature-prod, hotfix-prod

Примеры

# Staging окружение
Pattern: staging
Match: Equals
→ Ветка 'staging' → Staging окружение

# Release окружения
Pattern: release/
Match: Starts With
→ Ветка 'release/1.0' → Custom окружение

# Hotfix в production
Pattern: hotfix-
Match: Starts With
→ Ветка 'hotfix-urgent' → Custom окружение

Environment Variables и scope

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

1. Откройте Settings → Environment Variables
2. При создании переменной выберите Scope → Selected
3. Отметьте нужные окружения
4. Сохраните

Осторожно

Текущая модель хранит одну definition на Project/key. Она не поддерживает разные values одного key для разных Environment. Для изменения существующего scope или plain/secret category CLI требует явные safety flags. Полноценные Environment-owned overrides появятся в environment-first config model.

Пример без конфликтующих overrides:

# All environments
PUBLIC_API_URL=https://api.example.com

# Preview only
PREVIEW_BANNER=true

Custom Domains по окружениям

Production, Preview и Custom окружения могут иметь свои домены:

Окружение	Домен
Production	app.example.com
Preview	preview.example.com
Staging (Custom)	staging.app.example.com

Заметка

Development окружение не поддерживает custom domains. Для публичных URL используйте Production, Preview или Custom.

→ Подробнее о доменах

Auto Deploy

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

• Включён — webhook триггерит деплой при пуше в соответствующую ветку
• Выключен — деплои только вручную

1. Откройте Settings → Environments
2. Выберите окружение
3. Включите/выключите Auto Deploy
4. Для Preview или Custom при включении укажите Match Type и непустой Branch Pattern
5. Сохраните

Редактирование окружения

1. Откройте Settings → Environments
2. Нажмите на окружение
3. Измените настройки
4. Сохраните

Заметка

Production, Preview и Development окружения нельзя удалить. У системных окружений редактируется только доступная часть настроек: например, retention, Auto Deploy и шаблон ветки для Preview, blue-green для Production/Preview. Custom Domains можно добавлять к Production, Preview и Custom окружениям.

Удаление Custom окружения

1. Откройте Settings → Environments
2. Найдите Custom окружение
3. Нажмите удалить
4. Подтвердите

Осторожно

Перед удалением проверьте домены и текущий релиз окружения: независимого Deployment URL для продолжения доступа нет.

Выбор окружения для автодеплоя

Push в основную ветку направляется в Production. Для остальных веток ONREZA ищет включённое Preview или Custom окружение с совпадающим шаблоном.

• Один совпадающий шаблон — деплой в указанное окружение.
• Несколько совпадений — неоднозначная настройка; измените шаблоны.
• Нет совпадений — деплой не создаётся. Пустой шаблон Preview не означает «все ветки».

Для ветки preview настройте Preview: Auto Deploy включён, Match Type — Equals, Branch Pattern — preview. Для отдельной ветки staging создайте Custom окружение с Equals → staging. Каждое окружение сохраняет свой адрес.

Use Cases

Staging окружение

Name: Staging
Type: Custom
Pattern: staging
Match: Equals

• Отдельные environment variables
• Отдельный custom domain: staging.example.com
• Для финального тестирования перед production

Release branches

Name: Release
Type: Custom
Pattern: release/
Match: Starts With

• release/1.0, release/2.0 и т.д.
• Для подготовки релизов

Feature preview для определённой команды

Name: Design Preview
Type: Custom
Pattern: design-
Match: Starts With

• design-header, design-footer и т.д.
• Отдельный domain для дизайнеров: design.preview.example.com

API доступ

Управление окружениями и их переменными доступно через CLI:

# Список переменных окружения
nrz env list --environment preview

# Установить plain value
nrz env set PUBLIC_API_URL --value https://api.example.com --plain --all

# Установить secret без shell history
printf %s "$API_TOKEN" | nrz env set API_TOKEN --stdin --secret --environment preview

# Запустить локальную команду с materialized context без dotenv
nrz env exec --environment preview -- npm run dev

# Удалить project-wide definition
nrz env delete API_TOKEN --all

См. CLI Reference для подробностей.

Workflow: Development → Staging → Production

Типичный flow для команды с тремя окружениями:

1. Настройка окружений

Окружение	Branch Pattern	Match	Custom Domain
Production	main	(авто)	app.example.com
Staging	staging	Equals	staging.example.com
Preview	preview	Equals	—

2. Environment Variables

Задайте общие values с scope All Environments, а Environment-specific keys с scope Selected. До environment-first migration не создавайте разные values одного key для разных окружений:

# All Environments
API_URL=https://api.example.com

# Staging only
STAGING_FEATURE_GATE=true

# Preview only
PREVIEW_BANNER=true

3. Flow разработки

feature branch → Preview деплой → Code review
                                       ↓
                              Merge в staging
                                       ↓
                         Staging деплой → QA тестирование
                                       ↓
                              Merge в main
                                       ↓
                         Production деплой (автоматический)

4. Доступ к переменным в коде

// Переменная автоматически соответствует текущему окружению
const dbUrl = process.env.DATABASE_URL;
// Value comes from the immutable Deployment Environment snapshot.

Совет

Для быстрого управления plain-переменными используйте CLI: nrz env set KEY --value VALUE --plain --environment preview

Troubleshooting

Деплой попал не в то окружение

1. Проверьте Branch Pattern — возможно он слишком широкий
2. Проверьте Match Type — Starts With vs Equals
3. Проверьте приоритет — Custom окружения имеют приоритет

Environment Variables не применились

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

См. также

• Environment Variables — переменные окружения
• KV-хранилище — хранилище ключ-значение
• Custom Domains — настройка доменов
• Деплои — типы деплоев