Переменные окружения.
Ваши собственные переменные и те, что Rivervo задаёт за вас, основной сайт и превью, замена автоматического значения и когда изменения вступают в силу.
Ключи, пароли и настройки вашего приложения хранятся на вкладке Переменные. Они хранятся в зашифрованном виде и доходят до приложения как обычные переменные окружения.
Добавление своих переменных
Переменные → Добавить переменную, введите ИМЯ и значение, затем Сохранить.
- Имя состоит из латинских букв, цифр и
_и не начинается с цифры. Каждое имя должно быть уникальным. - Совет: вставьте содержимое файла
.envв поле имени — все строки добавятся сразу.
Переменные доступны приложению во время работы, а не на этапе сборки. Изменения доходят до приложения со следующим развёртыванием. После сохранения панель предлагает Развернуть сейчас — текущая версия разворачивается заново с новыми переменными, без новой сборки.
Основной сайт и превью
У каждой переменной есть Окружение:
| Окружение | Куда попадает |
|---|---|
| Основной сайт и превью | работающее приложение и каждое превью ветки (по умолчанию) |
| Только основной сайт | только работающее приложение — например, рабочий платёжный ключ |
| Только превью | только превью веток — например, тестовый платёжный ключ |
Превью получают только переменные, заданные для них. У превью также есть своя вкладка Переменные: там видно, что оно получает Из приложения, а ваше собственное значение с тем же именем заменяет их только для этого превью.
Задаются автоматически
В списке Задаются автоматически показано, что Rivervo предоставляет вашему приложению и поддерживает в актуальном состоянии. Добавлять эти переменные самостоятельно не нужно:
| Переменная | Когда |
|---|---|
PORT | всегда — порт, который слушает ваше приложение |
DATABASE_URL, DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD | в проекте есть база данных PostgreSQL или MySQL |
PGHOST, PGPORT, PGDATABASE, PGUSER, PGPASSWORD | база данных — PostgreSQL |
REDIS_URL, REDIS_HOST, REDIS_PORT, REDIS_PASSWORD, REDIS_CLIENT | в проекте есть Valkey |
RIVERVO_<NAME>_URL | для каждой базы данных, Valkey и реплики для чтения проекта — по имени сервиса |
S3_ENDPOINT, S3_REGION, S3_BUCKET, S3_KEY, S3_SECRET | в проекте есть объектное хранилище |
APP_KEY, APP_ENV, APP_DEBUG, APP_URL, LOG_CHANNEL, SESSION_DRIVER, CACHE_STORE | приложение на Laravel (см. Laravel) |
Первая база данных проекта получает привычные имена (DATABASE_URL, DB_*). Вторая добавляет только свою RIVERVO_<NAME>_URL, поэтому ничего не переключается само собой — см. Базы данных.
Замена автоматического значения
Ваша собственная переменная с тем же именем заменяет автоматическую; панель отмечает её как Используется ваше значение. Так можно направить приложение в другое место, например DATABASE_URL — на другую базу данных проекта.
Единственное исключение — PORT: им всегда управляет Rivervo.
Сервисы проекта
Каждый сервис проекта — фоновые процессы, задачи по расписанию, другие веб-сервисы — получает переменные проекта, включая его базу данных. У сервиса также могут быть собственные переменные, которые имеют приоритет над переменными проекта. Веб-сервис всегда получает собственную APP_URL. См. Сервисы проекта.
Кто видит значения
Значения видят владелец аккаунта и люди с ролью Разработчик или Администратор в приложении. Роль Только просмотр их не видит. См. Доступ к приложению.