Dienste eines Projekts: Webdienste, Worker und geplante Jobs.
Fügen Sie einem Projekt Hintergrund-Worker, geplante Jobs, weitere Webdienste, Datenbanken und Valkey hinzu – aus dem eigenen Code, einem anderen Repository oder einem fertigen Image –, erreichbar per Name und auf einer Rechnung.
Ein Projekt besteht selten aus nur einem Prozess. Neben der Hauptanwendung können Sie einen Queue-Worker, einen nächtlichen Job, eine separate API oder eine Datenbank betreiben – jeweils als Dienst mit eigenen Ressourcen, alles auf einer Rechnung.
Die Dienste finden Sie in der Anwendung unter Übersicht → Dienste → Dienst hinzufügen. Ein Projekt kann bis zu 10 Dienste haben. Der Hauptdienst muss zuerst gestartet sein, und das Abo des Projekts muss aktiv sein (der Testzeitraum zählt dazu).
Arten von Diensten
| Art | Was es ist |
|---|---|
| Webdienst | eine weitere Website oder API – mit öffentlicher Adresse oder nur intern |
| Hintergrund-Worker | läuft dauerhaft: Warteschlangen, Horizon, Celery, Consumer |
| Geplanter Job | startet nach Zeitplan (Cron-Format, UTC), erledigt seine Aufgabe und beendet sich |
| PostgreSQL, MySQL, Valkey | verwaltete Datenbanken – siehe Datenbanken |
| NATS, RabbitMQ | Message-Broker für Ereignisse und Warteschlangen, nur intern – siehe Ereignisse und Warteschlangen |
Öffentliche Adresse oder nur intern
Wenn Sie einen Webdienst hinzufügen, legen Sie fest, wie er erreichbar ist – vorausgewählt ist nichts:
- Öffentliche Adresse – aus dem Internet unter
https://<name>.rivervo.apperreichbar; eigene Domains sind möglich. - Nur intern – keine Adresse im Internet und keine Domains; nur die anderen Dienste der Anwendung erreichen ihn. Richtig für eine API hinter Ihrer Website, ein Admin-Backend oder eine Suchmaschine.
Hintergrund-Worker, geplante Jobs und Datenbanken sind nie öffentlich, daher gibt es für sie keine Auswahl. Ändern können Sie das später in den Einstellungen des Dienstes → Öffentliche Adresse – siehe Kommunikation zwischen Diensten.
Woher der Code kommt
Code dieses Projekts
Derselbe Code, nur anders gestartet: ein Queue-Worker, ein Scheduler, ein WebSocket-Server (zum Beispiel Laravel Reverb), ein Ordner eines Monorepos, eine separate API.
- Befehl ist Pflicht – was der Dienst ausführt, z. B.
php artisan queue:workodernode worker.js. - Ein Webdienst muss auf dem Port aus
$PORTlauschen. - Ein geplanter Job braucht zusätzlich einen Zeitplan im Cron-Format (UTC), z. B.
*/5 * * * *. - Jede neue Version des Hauptdienstes wird auch auf diese Dienste deployt, sie führen also immer denselben Code aus.
Ein anderes Repository
Ein Webdienst oder Hintergrund-Worker aus einem anderen Repository Ihres verbundenen Git-Kontos, mit eigenem Branch und bei Bedarf eigenem Projektordner sowie eigenen Build- und Startbefehlen (lassen Sie ein Feld leer, um die erkannten Werte zu verwenden). Er hat eigene Deployments und Versionen und deployt jeden Push auf seinen Branch. Branch-Vorschauen gibt es für Dienste noch nicht.
Ein fertiges Image
Ein Webdienst oder Hintergrund-Worker aus einem fertigen Image (Docker-Image) von Docker Hub, der GitHub Container Registry oder einer beliebigen anderen Registry – zum Beispiel nginx:1.27 oder ghcr.io/org/app:tag.
- Port – der Port, auf dem das Image lauscht; wir übergeben ihn auch in
$PORT. - Befehl – optional; bleibt das Feld leer, startet das Image so, wie es gebaut wurde.
- Private Registry – ein Benutzername und ein Passwort oder Zugriffstoken. Sie werden verschlüsselt gespeichert, nur zum Herunterladen des Images verwendet und nie wieder angezeigt.
- Bei aktivierten automatischen Deployments prüfen wir einmal täglich, ob der Tag auf eine neuere Version zeigt, und deployen sie. Image erneut herunterladen im Tab Deployments erledigt das sofort.
Kafka (Vorlage)
Kafka unter Dienst hinzufügen ist eine Vorlage per Klick: Sie legt einen Dienst aus dem offiziellen Apache-Kafka-Image (3.9) an – ein einzelner Broker im KRaft-Modus, ohne ZooKeeper. Geeignet für die Entwicklung und moderate Last.
- Nur intern – keine öffentliche Adresse und kein Zugriff von außen; nur die Dienste der Anwendung erreichen ihn.
- Die anderen Code-Dienste der Anwendung erhalten
KAFKA_BROKERS=<service name>:9092undRIVERVO_<NAME>_URL=<service name>:9092. - Topics werden bei der ersten Verwendung automatisch angelegt.
- Er startet mit 1 GB Arbeitsspeicher · 1 CPU-Kern · 10 GB Festplatte. Wie bei jedem Dienst aus einem fertigen Image können Sie Ressourcen und Variablen ändern.
- Seine Daten liegen im Datenordner des Dienstes auf dessen Festplatte.
Was fehlt:
- Ein einziger Broker – keine Replikation; jedes Topic hat den Replikationsfaktor 1.
- Keine verwalteten Kafka-Backups. Das tägliche Backup kopiert den Datenordner als Dateien, während Kafka läuft. Das ist kein konsistentes Kafka-Backup: Nach einer Wiederherstellung können neuere Nachrichten fehlen, oder Kafka muss beim Start seine Logs reparieren.
- Kein Wartungsfenster, kein Zugriff von außen und keine Kafka-Oberfläche.
- Kafka-Upgrades liegen bei Ihnen: Ändern Sie das Image in den Einstellungen des Dienstes.
Für Warteschlangen und Ereignisse mit Backups und fertig eingerichteten Verbindungsvariablen siehe Ereignisse und Warteschlangen – NATS und RabbitMQ.
Erreichbarkeit per Name
Die Dienste eines Projekts kommunizieren über ein privates Netzwerk per Name: Ein Dienst namens api ist für die anderen als api erreichbar, eine Datenbank namens db als db und der Hauptdienst als web. Datenverkehr zwischen den Diensten eines Projekts zählt nicht als Traffic.
Jeder Webdienst zeigt seine Interne Adresse – zum Beispiel http://api:8080 –, und die anderen Dienste erhalten sie in einer Variable, RIVERVO_API_URL. Wie das funktioniert, rein interne Dienste, mehrere Instanzen und Timeouts: Kommunikation zwischen Diensten.
Jeder Dienst erhält die Variablen des Projekts – einschließlich der Datenbankverbindung – und zusätzlich eigene Variablen, die Vorrang vor denen des Projekts haben. Siehe Umgebungsvariablen.
Ressourcen und Preis
Jeder Dienst hat eigenen Arbeitsspeicher, eigene CPU und eigene Festplatte, berechnet wie jede Anwendung: 6,50 € pro GB Arbeitsspeicher und 4,33 € pro CPU-Kern im Monat, mit 10 GB Festplatte inklusive pro GB Arbeitsspeicher, darüber hinaus 0,17 € pro GB. Ein Dienst kann bis zu 8 GB Arbeitsspeicher haben.
Wenn Sie einen Dienst hinzufügen, kommt sein Preis zur Rechnung des Projekts hinzu – für den laufenden Monat nur der verbleibende Anteil. Solange das Projekt im kostenlosen Testzeitraum ist, sind neue Dienste bis zu dessen Ende kostenlos.
Die Übersicht zeigt Projekt gesamt – was alle Dienste des Projekts zusammen im Monat kosten.
Worker innerhalb der Anwendung
Nicht immer braucht es einen separaten Dienst. Der Tab Prozesse der Hauptanwendung bietet:
- Hintergrund-Worker – bis zu 5 dauerhaft laufende Prozesse neben der Website, z. B. ein Queue-Worker. Sie teilen sich die Ressourcen der Anwendung und starten bei jedem Deployment neu.
- Geplante Befehle – bis zu 10 Befehle nach Zeitplan (Cron-Format, UTC). Ihre Ausgabe steht im Log unter Zeitplan.
- Konsole – einen einmaligen Befehl in der laufenden Anwendung ausführen, mit ihren Variablen und ihrer Datenbank. Ein Befehl darf bis zu 15 Minuten laufen; interaktive Befehle (tinker, eine Shell) werden hier nicht unterstützt.
Ein separater Dienst ist die bessere Wahl, wenn ein Worker eigene Ressourcen braucht – damit eine schwere Warteschlange die Website nie ausbremst.
Einen Dienst ändern
Öffnen Sie den Dienst aus der Liste Dienste. In seinen Einstellungen finden Sie Befehl, Zeitplan, Image oder Branch sowie seine Ressourcen; Änderungen werden gespeichert, und der Dienst startet damit neu. Jeder Dienst hat außerdem eigene Logs und ein eigenes Monitoring.