Услуги на проекта: уеб услуги, фонови процеси и задачи по график.
Добавете към проекта фонови процеси, задачи по график, още уеб услуги, бази данни и Valkey — от собствения му код, от друго хранилище или от готов образ, — достъпни по име и в една сметка.
Един проект е повече от един процес. До основното приложение можете да пуснете обработчик на опашки, нощна задача, отделен API, база данни — всяко като услуга със собствени ресурси, всички в една сметка.
Услугите са в Преглед на приложението → Услуги → Добавяне на услуга. Един проект може да има до 10 услуги. Основната услуга трябва да е стартирана първа, а абонаментът на проекта трябва да е активен (пробният период също се брои).
Видове услуги
| Вид | Какво е |
|---|---|
| Уеб услуга | още един сайт или API — с публичен адрес или само вътрешен |
| Фонов процес | работи постоянно: опашки, Horizon, Celery, консуматори |
| Задача по график | стартира по график (формат cron, UTC), свършва работата си и спира |
| PostgreSQL, MySQL, Valkey | управлявани бази данни — вижте Бази данни |
| NATS, RabbitMQ | брокери на съобщения за събития и опашки, само вътрешни — вижте Събития и опашки |
Публичен адрес или само вътрешна
Когато добавяте уеб услуга, изберете как ще бъде достъпна — нищо не е избрано предварително:
- Публичен адрес — отваря се от интернет на
https://<name>.rivervo.app; може да има ваши домейни. - Само вътрешна — без адрес в интернет и без домейни; достъпна е само за другите услуги на приложението. Подходяща за API зад сайта ви, административен бекенд или търсачка.
Фоновите процеси, задачите по график и базите данни никога не са публични, затова при тях няма избор. Можете да го промените по-късно в Настройки → Публичен адрес на услугата — вижте Комуникация между услугите.
Откъде идва кодът
Кодът на този проект
Същият код, стартиран по друг начин: обработчик на опашки, планировчик, WebSocket сървър (например Laravel Reverb), папка от monorepo, отделен API.
- Команда е задължителна — какво изпълнява услугата, например
php artisan queue:workилиnode worker.js. - Уеб услугата трябва да слуша на порта от
$PORT. - Задачата по график се нуждае и от График във формат cron (UTC), например
*/5 * * * *. - Всяка нова версия на основната услуга се деплойва и в тези услуги, така че те винаги изпълняват същия код.
Друго хранилище
Уеб услуга или фонов процес от друго хранилище на свързания ви Git акаунт, със собствен клон и при нужда Папка на проекта и Команди за изграждане и старт (оставете поле празно, за да използвате автоматично определеното). Тя има собствени деплои и версии и деплойва всеки push в своя клон. Прегледи на клонове за услугите все още не се правят.
Готов образ
Уеб услуга или фонов процес от готов образ (Docker image) в 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 GB памет · 1 процесорно ядро · 10 GB диск. Както при всяка услуга от готов образ, можете да променяте ресурсите и променливите ѝ.
- Данните ѝ се пазят в папката за данни на услугата на нейния диск.
Какво няма:
- Един брокер — без репликация; всяка тема има replication factor 1.
- Няма управлявани резервни копия на Kafka. Ежедневното резервно копие копира папката с данни като файлове, докато Kafka работи. Това не е консистентно резервно копие на Kafka: след възстановяване може да липсват последни съобщения или Kafka да трябва да възстанови логовете си при старт.
- Няма време за поддръжка, достъп отвън и Kafka UI.
- Обновяването на Kafka е ваша грижа: сменете образа в Настройки на услугата.
За опашки и събития с резервни копия и зададени вместо вас променливи за връзка вижте Събития и опашки — NATS и RabbitMQ.
Достъп една до друга по име
Услугите на проекта комуникират по частна мрежа по име: услуга с име api е достъпна за останалите като api, база данни с име db — като db, а основната услуга — като web. Трафикът между услугите на проекта не се брои като трафик.
Всяка уеб услуга показва своя Вътрешен адрес — например http://api:8080, — а другите услуги го получават в променлива, RIVERVO_API_URL. Как работи това, само вътрешните услуги, няколкото инстанции и таймаутите: Комуникация между услугите.
Всяка услуга получава променливите на проекта — включително връзката с базата данни — плюс собствени променливи, които имат предимство пред тези на проекта. Вижте Променливи на средата.
Ресурси и цена
Всяка услуга има собствени Памет, Процесор и Диск с цени като всяко приложение: 6,55 € на GB памет и 4,37 € на процесорно ядро месечно, с 10 GB диск включени за всеки GB памет, след това 0,17 € на GB. Една услуга може да има до 8 GB памет.
Когато добавите услуга, цената ѝ се добавя към сметката на проекта — за текущия месец само за оставащата му част. Докато проектът е в безплатния си пробен период, новите услуги са безплатни до края му.
Преглед показва Общо за проекта — колко струват всички услуги на проекта заедно на месец.
Фонови процеси в самото приложение
Не винаги е нужна отделна услуга. Разделът Процеси на основното приложение има:
- Фонови процеси — до 5 дълго работещи процеса до сайта, например обработчик на опашки. Те споделят ресурсите на приложението и се рестартират при всеки деплой.
- Команди по график — до 10 команди по график (формат cron, UTC). Изходът им е в лога под График.
- Конзола — изпълнете еднократна команда в работещото приложение, с неговите променливи и база данни. Командата може да работи до 15 минути; интерактивни команди (tinker, shell) тук не се поддържат.
Отделната услуга е по-добрият избор, когато фоновият процес се нуждае от собствени ресурси, така че тежка опашка никога да не забавя сайта.
Промяна на услуга
Отворете услугата от списъка Услуги. В нейните Настройки са командата, графикът, образът или клонът и ресурсите ѝ; промените се запазват и услугата се рестартира с тях. Всяка услуга има и собствени Логове и Мониторинг.