Почати

Сервіси проєкту: вебсервіси, фонові процеси й завдання за розкладом.

Додавайте до проєкту фонові процеси, завдання за розкладом, додаткові вебсервіси, бази даних і Valkey — з його власного коду, іншого репозиторію чи готового образу — з доступом за назвою та в одному рахунку.

5 ХВ ЧИТАННЯ

Проєкт — це більше, ніж один процес. Поруч з основним застосунком можна запустити обробник черги, нічне завдання, окремий 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, оболонка) тут не підтримуються.

Окремий сервіс кращий, коли фоновому процесу потрібні власні ресурси, щоб важка черга ніколи не гальмувала сайт.

Зміна сервісу

Відкрийте сервіс зі списку Сервіси. У його Налаштуваннях — команда, розклад, образ або гілка й ресурси; зміни зберігаються, і сервіс перезапускається з ними. Кожен сервіс також має власні вкладки Журнал і Моніторинг.

Залишилися питання?

Напишіть нам у чат — AI відповідає одразу, а інженер підключається за потреби в будь-який час доби.

Написати в підтримку