Usługi projektu: usługi webowe, workery i zadania harmonogramu.
Dodaj do projektu workery w tle, zadania harmonogramu, kolejne usługi webowe, bazy danych i Valkey — z jego własnego kodu, innego repozytorium lub gotowego obrazu — dostępne po nazwie i na jednym rachunku.
Projekt to więcej niż jeden proces. Obok głównej aplikacji możesz uruchomić worker kolejki, nocne zadanie, osobne API, bazę danych — każde jako usługę z własnymi zasobami, wszystko na jednym rachunku.
Usługi znajdziesz w aplikacji: Przegląd → Usługi → Dodaj usługę. Projekt może mieć do 10 usług. Najpierw trzeba uruchomić usługę główną, a subskrypcja projektu musi być aktywna (okres próbny też się liczy).
Rodzaje usług
| Rodzaj | Co to jest |
|---|---|
| Usługa webowa | kolejna strona lub API — z adresem publicznym albo tylko wewnętrzna |
| Worker w tle | działa cały czas: kolejki, Horizon, Celery, konsumenci |
| Zadanie harmonogramu | uruchamia się według harmonogramu (format cron, UTC), wykonuje pracę i się kończy |
| PostgreSQL, MySQL, Valkey | zarządzane bazy danych — zobacz Bazy danych |
| NATS, RabbitMQ | brokery wiadomości do zdarzeń i kolejek, tylko wewnętrzne — zobacz Zdarzenia i kolejki |
Adres publiczny czy tylko wewnętrzna
Gdy dodajesz usługę webową, wybierz, jak będzie dostępna — nic nie jest zaznaczone z góry:
- Adres publiczny — dostępna z internetu pod
https://<name>.rivervo.app; może mieć twoje własne domeny. - Tylko wewnętrzna — bez adresu w internecie i bez domen; docierają do niej tylko pozostałe usługi aplikacji. Dobre dla API za twoją stroną, zaplecza administracyjnego lub wyszukiwarki.
Workery w tle, zadania harmonogramu i bazy danych nigdy nie są publiczne, więc dla nich nie ma wyboru. Możesz to później zmienić w usłudze: Ustawienia → Adres publiczny — zobacz Komunikacja między usługami.
Skąd pochodzi kod
Kod tego projektu
Ten sam kod uruchomiony inaczej: worker kolejki, scheduler, serwer WebSocket (na przykład Laravel Reverb), folder monorepozytorium, osobne API.
- Polecenie jest wymagane — to, co usługa uruchamia, np.
php artisan queue:worklubnode worker.js. - Usługa webowa musi nasłuchiwać na porcie z
$PORT. - Zadanie harmonogramu potrzebuje też Harmonogramu w formacie cron (UTC), np.
*/5 * * * *. - Każda nowa wersja usługi głównej jest wdrażana także do tych usług, więc zawsze działa w nich ten sam kod.
Inne repozytorium
Usługa webowa lub worker w tle z innego repozytorium twojego podłączonego konta Git, z własną gałęzią i w razie potrzeby Folderem projektu oraz Poleceniami budowania i uruchomienia (zostaw pole puste, aby użyć tego, co wykryjemy). Ma własne wdrożenia i wersje i wdraża każdy push do swojej gałęzi. Podglądy gałęzi nie są jeszcze tworzone dla usług.
Gotowy obraz
Usługa webowa lub worker w tle z gotowego obrazu (obrazu Dockera) z Docker Hub, GitHub Container Registry lub dowolnego innego rejestru — na przykład nginx:1.27 lub ghcr.io/org/app:tag.
- Port — port, na którym nasłuchuje obraz; przekazujemy go też w
$PORT. - Polecenie — opcjonalne; puste uruchamia obraz tak, jak został zbudowany.
- Prywatny rejestr — nazwa użytkownika i hasło lub token dostępu. Przechowujemy je zaszyfrowane, używamy tylko do pobrania obrazu i nigdy więcej ich nie pokazujemy.
- Przy włączonych automatycznych wdrożeniach raz dziennie sprawdzamy, czy tag wskazuje nowszą wersję, i ją wdrażamy. Pobierz obraz ponownie na karcie Wdrożenia robi to od razu.
Kafka (szablon)
Kafka w Dodaj usługę to gotowe ustawienie na jedno kliknięcie: tworzy usługę z oficjalnego obrazu Apache Kafka (3.9) — pojedynczy broker w trybie KRaft, bez ZooKeepera. Nadaje się do developmentu i umiarkowanych obciążeń.
- Tylko wewnętrzna — bez adresu publicznego i bez dostępu z zewnątrz; docierają do niej tylko usługi aplikacji.
- Pozostałe usługi z kodem w aplikacji dostają
KAFKA_BROKERS=<service name>:9092iRIVERVO_<NAME>_URL=<service name>:9092. - Tematy (topics) tworzą się automatycznie przy pierwszym użyciu.
- Startuje z 1 GB pamięci · 1 rdzeniem CPU · 10 GB dysku. Jak w każdej usłudze z gotowego obrazu możesz zmienić jej zasoby i zmienne.
- Dane są przechowywane w folderze danych usługi na jej dysku.
Czego nie ma:
- Jeden broker — bez replikacji; każdy temat ma współczynnik replikacji 1.
- Brak zarządzanych kopii zapasowych Kafki. Codzienna kopia zapasowa kopiuje folder danych jako pliki, gdy Kafka działa. To nie jest spójna kopia Kafki: po przywróceniu może brakować ostatnich wiadomości albo Kafka może przy starcie musieć odtworzyć swoje logi.
- Brak okna serwisowego, dostępu z zewnątrz i interfejsu Kafka UI.
- Aktualizacja Kafki należy do ciebie: zmień obraz w Ustawieniach usługi.
Kolejki i zdarzenia z kopiami zapasowymi i gotowymi zmiennymi połączenia opisujemy w Zdarzenia i kolejki — NATS i RabbitMQ.
Komunikacja po nazwie
Usługi projektu rozmawiają ze sobą przez sieć prywatną po nazwie: usługa o nazwie api jest dostępna dla pozostałych jako api, baza danych o nazwie db jako db, a usługa główna jako web. Ruch między usługami projektu nie jest liczony jako transfer.
Każda usługa webowa pokazuje swój Adres wewnętrzny — na przykład http://api:8080 — a pozostałe usługi dostają go w zmiennej RIVERVO_API_URL. Jak to działa, usługi tylko wewnętrzne, kilka instancji i limity czasu: Komunikacja między usługami.
Każda usługa dostaje zmienne projektu — w tym połączenie z bazą danych — oraz własne zmienne, które mają pierwszeństwo przed zmiennymi projektu. Zobacz Zmienne środowiskowe.
Zasoby i cena
Każda usługa ma własną Pamięć, CPU i Dysk, wycenione jak każda aplikacja: 29,68 zł za GB pamięci i 19,78 zł za rdzeń CPU miesięcznie, z 10 GB dysku w cenie na każdy GB pamięci, a potem 0,74 zł za GB. Usługa może mieć do 8 GB pamięci.
Gdy dodajesz usługę, jej cena trafia na rachunek projektu — za bieżący miesiąc tylko za pozostałą jego część. Dopóki projekt jest w darmowym okresie próbnym, nowe usługi są darmowe do końca okresu próbnego.
Przegląd pokazuje Sumę projektu — ile wszystkie usługi projektu kosztują razem miesięcznie.
Workery w samej aplikacji
Nie zawsze potrzebujesz osobnej usługi. Karta Procesy głównej aplikacji ma:
- Workery w tle — do 5 długo działających procesów obok strony, np. worker kolejki. Dzielą zasoby aplikacji i restartują się przy każdym wdrożeniu.
- Polecenia harmonogramu — do 10 poleceń uruchamianych według harmonogramu (format cron, UTC). Ich wynik jest w logu pod Harmonogram.
- Konsola — uruchom jednorazowe polecenie w działającej aplikacji, z jej zmiennymi i bazą danych. Polecenie może działać do 15 minut; polecenia interaktywne (tinker, powłoka) nie są tu obsługiwane.
Osobna usługa jest lepszym wyborem, gdy worker potrzebuje własnych zasobów — wtedy ciężka kolejka nigdy nie spowolni strony.
Zmiana usługi
Otwórz usługę z listy Usługi. W jej Ustawieniach są polecenie, harmonogram, obraz lub gałąź oraz zasoby; zmiany są zapisywane, a usługa restartuje się z nimi. Każda usługa ma też własne Logi i Monitorowanie.