Diensten van een project: webdiensten, workers en geplande taken.
Voeg achtergrondworkers, geplande taken, extra webdiensten, databases en Valkey toe aan een project — vanuit de eigen code, een andere repository of een kant-en-klare image — bereikbaar op naam en op één rekening.
Een project is meer dan één proces. Naast de hoofdapplicatie kun je een queue-worker, een nachtelijke taak, een aparte API of een database draaien — elk als dienst met eigen resources, allemaal op één rekening.
De diensten staan in het Overzicht van de applicatie → Diensten → Dienst toevoegen. Een project kan maximaal 10 diensten hebben. De hoofddienst moet eerst gestart zijn en het abonnement van het project moet actief zijn (de proefperiode telt ook).
Soorten diensten
| Soort | Wat het is |
|---|---|
| Webdienst | nog een site of API — met een openbaar adres of alleen intern |
| Achtergrondworker | draait continu: wachtrijen, Horizon, Celery, consumers |
| Geplande taak | start volgens een planning (cron-formaat, UTC), doet zijn werk en stopt |
| PostgreSQL, MySQL, Valkey | beheerde databases — zie Databases |
| NATS, RabbitMQ | message brokers voor events en wachtrijen, alleen intern — zie Events en wachtrijen |
Openbaar adres of alleen intern
Als je een webdienst toevoegt, kies je hoe die bereikbaar is — er is vooraf niets geselecteerd:
- Openbaar adres — bereikbaar vanaf het internet op
https://<name>.rivervo.app; er kunnen eigen domeinen aan gekoppeld worden. - Alleen intern — geen adres op het internet en geen domeinen; alleen de andere diensten van de applicatie kunnen hem bereiken. Geschikt voor een API achter je site, een beheerbackend of een zoekmachine.
Achtergrondworkers, geplande taken en databases zijn nooit openbaar, dus voor die diensten is er niets te kiezen. Je kunt het later wijzigen via Instellingen van de dienst → Openbaar adres — zie Communicatie tussen diensten.
Waar de code vandaan komt
De code van dit project
Dezelfde code, op een andere manier gestart: een queue-worker, een scheduler, een WebSocket-server (bijvoorbeeld Laravel Reverb), een map uit een monorepo, een aparte API.
- Opdracht is verplicht — wat de dienst uitvoert, bijvoorbeeld
php artisan queue:workofnode worker.js. - Een webdienst moet luisteren op de poort uit
$PORT. - Een geplande taak heeft ook een Planning in cron-formaat (UTC) nodig, bijvoorbeeld
*/5 * * * *. - Elke nieuwe versie van de hoofddienst wordt ook naar deze diensten gedeployd, zodat ze altijd dezelfde code draaien.
Een andere repository
Een webdienst of achtergrondworker uit een andere repository van je gekoppelde Git-account, met een eigen branch en zo nodig een eigen Projectmap en Build- en startopdrachten (laat een veld leeg om te gebruiken wat wij herkennen). Zo'n dienst heeft eigen deploys en versies en deployt elke push naar zijn branch. Branch-previews worden voor diensten nog niet gemaakt.
Een kant-en-klare image
Een webdienst of achtergrondworker vanuit een kant-en-klare image (Docker-image) op Docker Hub, GitHub Container Registry of een andere registry — bijvoorbeeld nginx:1.27 of ghcr.io/org/app:tag.
- Poort — de poort waarop de image luistert; we geven die ook door in
$PORT. - Opdracht — optioneel; leeg betekent dat de image start zoals hij is gebouwd.
- Privéregistry — een gebruikersnaam en een wachtwoord of toegangstoken. Die worden versleuteld opgeslagen, alleen gebruikt om de image te downloaden en nooit meer getoond.
- Staan automatische deploys aan, dan controleren we één keer per dag of de tag naar een nieuwere versie wijst en deployen we die. Image opnieuw downloaden op het tabblad Deploys doet dat meteen.
Kafka (sjabloon)
Kafka onder Dienst toevoegen is een kant-en-klare instelling met één klik: er wordt een dienst gemaakt vanuit de officiële Apache Kafka-image (3.9) — één broker in KRaft-modus, zonder ZooKeeper. Geschikt voor ontwikkeling en gemiddelde belasting.
- Alleen intern — geen openbaar adres en geen toegang van buitenaf; alleen de diensten van de applicatie kunnen hem bereiken.
- De andere codediensten van de applicatie krijgen
KAFKA_BROKERS=<service name>:9092enRIVERVO_<NAME>_URL=<service name>:9092. - Topics worden automatisch aangemaakt zodra ze voor het eerst worden gebruikt.
- Hij start met 1 GB geheugen · 1 CPU-core · 10 GB schijfruimte. Net als bij elke dienst vanuit een kant-en-klare image kun je de resources en variabelen wijzigen.
- De data staat in de datamap van de dienst op zijn schijf.
Wat er niet bij zit:
- Eén broker — geen replicatie; elke topic heeft een replicatiefactor van 1.
- Geen beheerde Kafka-back-ups. De dagelijkse back-up kopieert de datamap als bestanden terwijl Kafka draait. Dat is geen consistente Kafka-back-up: na een herstel kunnen recente berichten ontbreken, of moet Kafka bij het starten zijn logs herstellen.
- Geen onderhoudsvenster, geen toegang van buitenaf en geen Kafka-UI.
- Kafka upgraden doe je zelf: wijzig de image in de Instellingen van de dienst.
Wil je wachtrijen en events met back-ups en verbindingsvariabelen die voor je zijn ingesteld, zie dan Events en wachtrijen — NATS en RabbitMQ.
Elkaar bereiken op naam
De diensten van een project praten met elkaar over een privénetwerk, op naam: een dienst die api heet, is voor de andere bereikbaar als api, een database die db heet als db, en de hoofddienst als web. Verkeer tussen de diensten van een project telt niet als verkeer.
Elke webdienst toont zijn Intern adres — bijvoorbeeld http://api:8080 — en de andere diensten krijgen dat in een variabele, RIVERVO_API_URL. Hoe het werkt, diensten die alleen intern zijn, meerdere instances en time-outs: Communicatie tussen diensten.
Elke dienst krijgt de variabelen van het project — ook de databaseverbinding — plus eigen variabelen, die voorgaan op die van het project. Zie Omgevingsvariabelen.
Resources en prijs
Elke dienst heeft eigen Geheugen, CPU en Schijf, geprijsd zoals elke applicatie: € 6,61 per GB geheugen en € 4,40 per CPU-core per maand, met 10 GB schijfruimte inbegrepen per GB geheugen, daarna € 0,17 per GB. Een dienst kan maximaal 8 GB geheugen hebben.
Als je een dienst toevoegt, komt de prijs bij de rekening van het project — voor de lopende maand alleen het resterende deel. Zolang het project in de gratis proefperiode zit, zijn nieuwe diensten gratis tot de proefperiode afloopt.
Het Overzicht toont het Projecttotaal — wat alle diensten van het project samen per maand kosten.
Workers binnen de applicatie zelf
Een aparte dienst is niet altijd nodig. Het tabblad Processen van de hoofdapplicatie heeft:
- Achtergrondworkers — maximaal 5 langlopende processen naast de site, bijvoorbeeld een queue-worker. Ze delen de resources van de applicatie en herstarten bij elke deploy.
- Geplande opdrachten — maximaal 10 opdrachten volgens een planning (cron-formaat, UTC). De uitvoer staat in het log onder Planning.
- Console — voer een eenmalige opdracht uit binnen de draaiende applicatie, met de variabelen en database daarvan. Een opdracht mag maximaal 15 minuten duren; interactieve opdrachten (tinker, een shell) worden hier niet ondersteund.
Een aparte dienst is de betere keuze als een worker eigen resources nodig heeft, zodat een zware wachtrij de site nooit vertraagt.
Een dienst wijzigen
Open de dienst vanuit de lijst Diensten. In de Instellingen staan de opdracht, de planning, de image of de branch, en de resources; wijzigingen worden opgeslagen en de dienst herstart ermee. Elke dienst heeft ook eigen Logs en Monitoring.