Как использовать переменные в сервисах

Backend-сервис получает переменные выбранной среды при публикации. Код сервиса читает их из окружения запуска, поэтому приватные значения не нужно хранить в репозитории.

• Сервису нужен адрес базы данных, API-ключ или другая настройка среды.
• Одно и то же приложение работает с разными значениями в production, preview или dev.
• Нужно заменить значение без изменения исходного кода.

• Создайте переменную в нужной среде проекта.
• Проверьте точное имя переменной.
• Не вставляйте приватное значение в логи, публичный код или сообщения.
• Изменять переменные могут владелец рабочего пространства и участники проекта

с ролью admin или developer. Роль platform_user позволяет читать имена и время обновления, но не изменять значения.

1. Откройте Переменные проекта и выберите нужную среду.
2. Добавьте переменную или обновите ее значение.
3. В коде backend-сервиса прочитайте значение из окружения.
4. Проверьте, что код обрабатывает отсутствие обязательной переменной.
5. Опубликуйте backend-сервис, чтобы он получил новое значение.

const databaseUrl = process.env.DATABASE_URL;

if (!databaseUrl) {
  throw new Error('DATABASE_URL is required');
}

Runtime SDK использует собственный служебный контекст. Для чтения ваших переменных SDK не нужен.

После изменения значения выполните новую публикацию backend-сервиса. Список переменных покажет имя и время обновления, но не само значение.

Переменные относятся к выбранной среде проекта. Настройка Live не меняет Preview или Dev; переключение среды показывает другой набор. Сохранение переменной само по себе не обновляет уже работающий сервис.

При доступном нативном разделе откройте выбранное окружение проекта и Переменные. После записи проверьте правила использования переменных и отдельно выполните нужную публикацию. Запись ключа не обновляет уже развёрнутое приложение автоматически.