Aan de slag

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.

6 MIN LEESTIJD

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

SoortWat het is
Webdienstnog een site of API — met een openbaar adres of alleen intern
Achtergrondworkerdraait continu: wachtrijen, Horizon, Celery, consumers
Geplande taakstart volgens een planning (cron-formaat, UTC), doet zijn werk en stopt
PostgreSQL, MySQL, Valkeybeheerde databases — zie Databases
NATS, RabbitMQmessage 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:work of node 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>:9092 en RIVERVO_<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.

Kom je er niet uit?

Chat met ons — de AI antwoordt meteen en een technicus komt erbij als dat nodig is, op elk moment van de dag.

Contact met support