Змінні середовища.
Ваші власні змінні й ті, що 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 і репліки для читання в проєкті — за назвою сервісу |
RIVERVO_<NAME>_URL | для кожного іншого вебсервісу застосунку — його внутрішня адреса, наприклад RIVERVO_API_URL=http://api:8080 (див. Взаємодія сервісів) |
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. Кожен сервіс із кодом також отримує внутрішню адресу кожного іншого вебсервісу як RIVERVO_<NAME>_URL; після того як ви додали чи перейменували вебсервіс, розгорніть інші сервіси ще раз, щоб вони її отримали. Див. Сервіси проєкту.
Хто бачить значення
Значення бачать власник акаунта й люди з роллю Розробник або Адміністратор у застосунку. Роль Лише перегляд їх не бачить. Див. Доступ до застосунку.