Zacznij

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.

5 MIN CZYTANIA

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

RodzajCo to jest
Usługa webowakolejna strona lub API — z adresem publicznym albo tylko wewnętrzna
Worker w tledziała cały czas: kolejki, Horizon, Celery, konsumenci
Zadanie harmonogramuuruchamia się według harmonogramu (format cron, UTC), wykonuje pracę i się kończy
PostgreSQL, MySQL, Valkeyzarządzane bazy danych — zobacz Bazy danych
NATS, RabbitMQbrokery 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:work lub node 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>:9092 i RIVERVO_<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.

Nadal masz pytania?

Napisz do nas na czacie — AI odpowiada od razu, a inżynier dołącza, gdy trzeba, o każdej porze.

Kontakt z pomocą techniczną