Започнете

Услуги на проекта: уеб услуги, фонови процеси и задачи по график.

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

6 МИН. ЧЕТЕНЕ

Един проект е повече от един процес. До основното приложение можете да пуснете обработчик на опашки, нощна задача, отделен 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) тук не се поддържат.

Отделната услуга е по-добрият избор, когато фоновият процес се нуждае от собствени ресурси, така че тежка опашка никога да не забавя сайта.

Промяна на услуга

Отворете услугата от списъка Услуги. В нейните Настройки са командата, графикът, образът или клонът и ресурсите ѝ; промените се запазват и услугата се рестартира с тях. Всяка услуга има и собствени Логове и Мониторинг.

Още имате въпроси?

Пишете ни в чата — AI отговаря веднага, а инженер се включва, когато е нужно, по всяко време на денонощието.

Връзка с поддръжката