Workspace Variables

Workspace Variables — переменные окружения, общие для нескольких проектов в workspace.

Для чего использовать

Общие API ключи — например, ключ аналитики для всех проектов
URL сервисов — общий backend для всех frontend приложений
Конфигурация инфраструктуры — URL базы данных для микросервисов

Где найти

Workspace → Settings → Environment Variables

Или:

Team Settings → Environment Variables (для командных workspace)

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

Откройте настройки workspace

Нажмите на имя workspace → Settings → Environment Variables
Нажмите “Add Variable”

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

Поле	Описание
Key	Имя переменной
Value	Значение
Secret	Зашифровать
Environment Types	Типы окружений
Projects	К каким проектам применить

Сохраните

Environment Types

Workspace переменные можно применить к определённым типам окружений:

Тип	Описание
Production	Только production деплои
Preview	Только preview деплои
Development	Для локальной разработки (функционал в разработке)
Custom	Custom окружения

Пример:

# Для всех production деплоев всех проектов
ANALYTICS_KEY=UA-123456

# Для всех preview деплоев
ANALYTICS_KEY=UA-STAGING

Связывание с проектами

Workspace переменные требуют явного связывания с проектами. Это делается при создании переменной или позже через настройки.

Добавление проектов

Откройте Workspace Environment Variables
Найдите переменную
Нажмите Link Projects
Выберите проекты
Сохраните

Удаление из проекта

Найдите переменную
Нажмите Unlink Projects
Снимите галочки с проектов
Сохраните

Приоритет

При конфликте имён:

Project Variable — высший приоритет
Workspace Variable — если нет project variable

Project "web":
  API_URL = https://api.prod.com  (Project Variable)

Workspace:
  API_URL = https://api.staging.com  (Workspace Variable)

→ Деплой использует: https://api.prod.com (Project имеет приоритет)

Просмотр в проекте

В настройках Environment Variables проекта связанные workspace переменные отображаются в секции Shared Variables:

Показывает все связанные Workspace Variables
Можно отвязать переменную от проекта
Нельзя изменить значение (только в Workspace Settings)

Секреты Workspace

Это отличается от project secrets, которые можно просматривать через Reveal.

Изменение значения

Откройте Workspace Settings → Environment Variables
Найдите переменную
Измените значение
Сохраните

Удаление

Найдите переменную
Нажмите удалить (корзина)
Подтвердите

Use Cases

Общий API ключ

# Workspace Variable (All Projects, All Environment Types)
ANALYTICS_KEY=UA-123456789

# Используется во всех проектах без дополнительной настройки

Разные базы данных

# Workspace Variable (All Projects, Production)
DATABASE_URL=postgres://prod-db.example.com/db

# Workspace Variable (All Projects, Preview)
DATABASE_URL=postgres://staging-db.example.com/db

Микросервисы

# Workspace Variable (Selected: api, web, admin)
AUTH_SERVICE_URL=https://auth.internal.example.com

# Workspace Variable (Selected: api)
DATABASE_URL=postgres://...  # Только для API сервиса

Troubleshooting

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

Проверьте Scope — возможно она для Selected Projects
Проверьте что проект связан с переменной
Проверьте Environment Types — возможно она не для этого типа окружения

Значение из Workspace не используется

Проверьте нет ли Project Variable с таким же именем (она имеет приоритет)
Проверьте что сделали деплой после связывания

Изменение не применилось

Workspace Variables требуют редеплоя
Проверьте что все проекты перезадеплоены

См. также

Project Variables — переменные проекта
Окружения — типы окружений
Деплои — развёртывание