Сервіси проєкту: вебсервіси, фонові процеси й завдання за розкладом.
Додавайте до проєкту фонові процеси, завдання за розкладом, додаткові вебсервіси, бази даних і Valkey — з його власного коду, іншого репозиторію чи готового образу — з доступом за назвою та в одному рахунку.
Проєкт — це більше, ніж один процес. Поруч з основним застосунком можна запустити обробник черги, нічне завдання, окремий API, базу даних — кожен як сервіс із власними ресурсами, і все це в одному рахунку.
Сервіси перелічено в застосунку на сторінці Огляд → Сервіси → Додати сервіс. У проєкті може бути до 10 сервісів. Спершу має бути запущений основний сервіс, а підписка проєкту має бути активною (пробний період теж підходить).
Види сервісів
| Вид | Що це |
|---|---|
| Вебсервіс | ще один сайт або API — з публічною адресою або лише внутрішній |
| Фоновий процес | працює постійно: черги, Horizon, Celery, споживачі повідомлень |
| Завдання за розкладом | запускається за розкладом (формат cron, UTC), виконує роботу й зупиняється |
| PostgreSQL, MySQL, Valkey | керовані бази даних — див. Бази даних |
| NATS, RabbitMQ | брокери повідомлень для подій і черг, лише внутрішні — див. Події та черги |
Публічна адреса чи лише внутрішній
Коли ви додаєте вебсервіс, оберіть, як до нього можна звертатися, — заздалегідь нічого не вибрано:
- Публічна адреса — доступний з інтернету за адресою
https://<name>.rivervo.app; можна підключити власні домени. - Лише внутрішній — без адреси в інтернеті й без доменів; до нього звертаються тільки інші сервіси застосунку. Підходить для API за вашим сайтом, адмінського бекенду чи пошукового рушія.
Фонові процеси, завдання за розкладом і бази даних ніколи не бувають публічними, тож для них вибору немає. Змінити це пізніше можна в сервісі: Налаштування → Публічна адреса — див. Взаємодія сервісів.
Звідки береться код
Код цього проєкту
Той самий код, запущений по-іншому: обробник черги, планувальник, WebSocket-сервер (наприклад, Laravel Reverb), папка монорепозиторію, окремий API.
- Команда обов’язкова — що запускає сервіс, наприклад
php artisan queue:workабоnode worker.js. - Вебсервіс має слухати порт із
$PORT. - Завданню за розкладом потрібен ще й Розклад у форматі cron (UTC), наприклад
*/5 * * * *. - Кожна нова версія основного сервісу розгортається й у ці сервіси, тож вони завжди працюють з тим самим кодом.
Інший репозиторій
Вебсервіс або фоновий процес з іншого репозиторію вашого підключеного Git-акаунта — із власною гілкою та, за потреби, Папкою проєкту і Командами збирання й запуску (залиште поле порожнім, щоб використати те, що ми визначимо самі). Він має власні розгортання й версії та розгортає кожен push у свою гілку. Прев’ю гілок для сервісів поки не створюються.
Готовий образ
Вебсервіс або фоновий процес із готового образу (Docker-образу) з Docker Hub, GitHub Container Registry чи будь-якого іншого реєстру — наприклад, nginx:1.27 або ghcr.io/org/app:tag.
- Порт — порт, який слухає образ; ми також передаємо його в
$PORT. - Команда — необов’язкова; якщо поле порожнє, образ запускається так, як його зібрано.
- Приватний реєстр — ім’я користувача й пароль або токен доступу. Вони зберігаються зашифрованими, використовуються лише для завантаження образу й більше ніколи не показуються.
- Якщо автоматичні розгортання ввімкнено, ми раз на день перевіряємо, чи тег не вказує на новішу версію, і розгортаємо її. Завантажити образ знову на вкладці Розгортання робить це одразу.
Kafka (шаблон)
Kafka у Додати сервіс — це готовий шаблон в один клік: він створює сервіс з офіційного образу Apache Kafka (3.9) — один брокер у режимі KRaft, без ZooKeeper. Підходить для розробки й помірних навантажень.
- Лише внутрішній — без публічної адреси й без доступу ззовні; до нього звертаються тільки сервіси застосунку.
- Інші сервіси застосунку з кодом отримують
KAFKA_BROKERS=<service name>:9092іRIVERVO_<NAME>_URL=<service name>:9092. - Топіки створюються автоматично під час першого використання.
- На старті: 1 ГБ пам’яті · 1 ядро CPU · 10 ГБ диска. Як і для будь-якого сервісу з готового образу, ресурси й змінні можна змінити.
- Дані зберігаються в папці даних сервісу на його диску.
Чого в ньому немає:
- Один брокер — без реплікації; кожен топік має фактор реплікації 1.
- Немає керованих резервних копій Kafka. Щоденна резервна копія копіює папку даних як файли, поки Kafka працює. Це не узгоджена резервна копія Kafka: після відновлення можуть бракувати останніх повідомлень, або Kafka доведеться відновлювати свої журнали під час запуску.
- Немає вікна обслуговування, доступу ззовні й інтерфейсу Kafka UI.
- Оновлення Kafka — ваша справа: змініть образ у Налаштуваннях сервісу.
Черги й події з резервними копіями та готовими змінними для підключення — це NATS і RabbitMQ, див. Події та черги.
Звертання один до одного за назвою
Сервіси проєкту спілкуються через приватну мережу за назвою: сервіс api доступний для інших як api, база даних db — як db, а основний сервіс — як web. Трафік між сервісами проєкту не враховується як трафік.
Кожен вебсервіс показує свою Внутрішню адресу — наприклад, http://api:8080, — а інші сервіси отримують її у змінній RIVERVO_API_URL. Як це працює, сервіси лише для внутрішнього доступу, кілька екземплярів і тайм-аути — у статті Взаємодія сервісів.
Кожен сервіс отримує змінні проєкту — зокрема підключення до бази даних — і власні змінні, які мають пріоритет над змінними проєкту. Див. Змінні середовища.
Ресурси й ціна
У кожного сервісу власні Пам’ять, CPU і Диск, і ціна така сама, як для будь-якого застосунку: 326,41 ₴ за ГБ пам’яті та 217,61 ₴ за ядро CPU на місяць, 10 ГБ диска включено на кожен ГБ пам’яті, далі — 8,16 ₴ за ГБ. Сервіс може мати до 8 ГБ пам’яті.
Коли ви додаєте сервіс, його ціна додається до рахунку проєкту — за поточний місяць лише за решту місяця. Поки проєкт на безкоштовному пробному періоді, нові сервіси безкоштовні до його завершення.
На сторінці Огляд показано Разом за проєкт — скільки всі сервіси проєкту разом коштують на місяць.
Фонові процеси всередині самого застосунку
Окремий сервіс потрібен не завжди. На вкладці Процеси основного застосунку є:
- Фонові процеси — до 5 довготривалих процесів поруч із сайтом, наприклад обробник черги. Вони ділять ресурси застосунку й перезапускаються з кожним розгортанням.
- Команди за розкладом — до 10 команд за розкладом (формат cron, UTC). Їхній вивід — у журналі в розділі Розклад.
- Консоль — виконайте разову команду в запущеному застосунку, з його змінними й базою даних. Команда може працювати до 15 хвилин; інтерактивні команди (tinker, оболонка) тут не підтримуються.
Окремий сервіс кращий, коли фоновому процесу потрібні власні ресурси, щоб важка черга ніколи не гальмувала сайт.
Зміна сервісу
Відкрийте сервіс зі списку Сервіси. У його Налаштуваннях — команда, розклад, образ або гілка й ресурси; зміни зберігаються, і сервіс перезапускається з ними. Кожен сервіс також має власні вкладки Журнал і Моніторинг.