Υπηρεσίες ενός project: web υπηρεσίες, workers και προγραμματισμένες εργασίες.
Πρόσθεσε background workers, προγραμματισμένες εργασίες, περισσότερες web υπηρεσίες, βάσεις δεδομένων και Valkey σε ένα project — από τον δικό του κώδικα, άλλο repository ή έτοιμο image — προσβάσιμα με το όνομά τους και σε έναν λογαριασμό χρέωσης.
Ένα project είναι κάτι περισσότερο από μία διεργασία. Δίπλα στην κύρια εφαρμογή μπορείς να τρέχεις έναν queue worker, μια νυχτερινή εργασία, ένα ξεχωριστό API, μια βάση δεδομένων — το καθένα ως υπηρεσία με δικούς της πόρους, όλα σε μία χρέωση.
Οι υπηρεσίες βρίσκονται στην Επισκόπηση της εφαρμογής → Υπηρεσίες → Προσθήκη υπηρεσίας. Ένα project μπορεί να έχει έως 10 υπηρεσίες. Η κύρια υπηρεσία πρέπει να έχει ξεκινήσει πρώτα και η συνδρομή του project πρέπει να είναι ενεργή (η δοκιμή μετράει).
Είδη υπηρεσιών
| Είδος | Τι είναι |
|---|---|
| Web υπηρεσία | άλλη ιστοσελίδα ή API — με δημόσια διεύθυνση ή μόνο εσωτερική |
| Background worker | τρέχει συνεχώς: ουρές, Horizon, Celery, consumers |
| Προγραμματισμένη εργασία | ξεκινά βάσει χρονοπρογραμματισμού (μορφή cron, UTC), κάνει τη δουλειά της και σταματά |
| PostgreSQL, MySQL, Valkey | διαχειριζόμενες βάσεις δεδομένων — δες Βάσεις δεδομένων |
| NATS, RabbitMQ | message brokers για συμβάντα και ουρές, μόνο εσωτερικοί — δες Συμβάντα και ουρές |
Δημόσια διεύθυνση ή μόνο εσωτερική
Όταν προσθέτεις μια web υπηρεσία, επιλέγεις πώς θα είναι προσβάσιμη — τίποτα δεν είναι προεπιλεγμένο:
- Δημόσια διεύθυνση — ανοίγει από το internet στο
https://<name>.rivervo.app· μπορεί να έχει δικά σου domain. - Μόνο εσωτερική — χωρίς διεύθυνση στο internet και χωρίς domain· μόνο οι άλλες υπηρεσίες της εφαρμογής φτάνουν σε αυτήν. Κατάλληλη για ένα API πίσω από την ιστοσελίδα σου, ένα διαχειριστικό backend ή μια μηχανή αναζήτησης.
Οι background workers, οι προγραμματισμένες εργασίες και οι βάσεις δεδομένων δεν είναι ποτέ δημόσιες, οπότε για αυτές δεν υπάρχει επιλογή. Μπορείς να το αλλάξεις αργότερα στις Ρυθμίσεις → Δημόσια διεύθυνση της υπηρεσίας — δες Επικοινωνία μεταξύ υπηρεσιών.
Από πού έρχεται ο κώδικας
Ο κώδικας αυτού του project
Ο ίδιος κώδικας, που ξεκινά με άλλον τρόπο: ένας queue worker, ένας scheduler, ένας WebSocket server (για παράδειγμα Laravel Reverb), ένας φάκελος ενός monorepo, ένα ξεχωριστό API.
- Η Εντολή είναι υποχρεωτική — τι εκτελεί η υπηρεσία, π.χ.
php artisan queue:workήnode worker.js. - Μια web υπηρεσία πρέπει να ακούει στη θύρα του
$PORT. - Μια προγραμματισμένη εργασία χρειάζεται επίσης Χρονοπρογραμματισμό σε μορφή cron (UTC), π.χ.
*/5 * * * *. - Κάθε νέα έκδοση της κύριας υπηρεσίας γίνεται deploy και σε αυτές τις υπηρεσίες, ώστε να τρέχουν πάντα τον ίδιο κώδικα.
Άλλο repository
Μια web υπηρεσία ή ένας background worker από άλλο repository του συνδεδεμένου λογαριασμού σου στο Git, με δικό του branch και, αν χρειάζεται, Φάκελο project και Εντολές build και εκκίνησης (άφησε ένα πεδίο κενό για να χρησιμοποιηθεί αυτό που εντοπίζουμε). Έχει δικά του deploys και εκδόσεις και κάνει deploy κάθε push στο branch του. Previews ανά branch δεν δημιουργούνται ακόμη για υπηρεσίες.
Έτοιμο image
Μια web υπηρεσία ή ένας background worker από έτοιμο image (Docker image) στο Docker Hub, στο GitHub Container Registry ή σε οποιοδήποτε άλλο registry — για παράδειγμα nginx:1.27 ή ghcr.io/org/app:tag.
- Θύρα — η θύρα στην οποία ακούει το image· τη δίνουμε και στο
$PORT. - Εντολή — προαιρετική· αν είναι κενή, το image ξεκινά όπως έχει φτιαχτεί.
- Ιδιωτικό registry — όνομα χρήστη και κωδικός ή access token. Αποθηκεύονται κρυπτογραφημένα, χρησιμοποιούνται μόνο για τη λήψη του image και δεν εμφανίζονται ποτέ ξανά.
- Με τα αυτόματα deploys ενεργά, ελέγχουμε μία φορά την ημέρα αν το tag δείχνει σε νεότερη έκδοση και την κάνουμε deploy. Η Νέα λήψη του image στην καρτέλα Deploys το κάνει αμέσως.
Kafka (πρότυπο)
Το Kafka στην Προσθήκη υπηρεσίας είναι έτοιμη ρύθμιση με ένα κλικ: δημιουργεί υπηρεσία από το επίσημο image του Apache Kafka (3.9) — έναν broker σε λειτουργία KRaft, χωρίς ZooKeeper. Ταιριάζει για development και μέτριους φόρτους.
- Μόνο εσωτερική — χωρίς δημόσια διεύθυνση και χωρίς πρόσβαση από έξω· μόνο οι υπηρεσίες της εφαρμογής φτάνουν σε αυτήν.
- Οι άλλες υπηρεσίες κώδικα της εφαρμογής παίρνουν
KAFKA_BROKERS=<service name>:9092καιRIVERVO_<NAME>_URL=<service name>:9092. - Τα topics δημιουργούνται αυτόματα την πρώτη φορά που χρησιμοποιούνται.
- Ξεκινά με 1 GB μνήμης · 1 πυρήνα CPU · 10 GB δίσκου. Όπως κάθε υπηρεσία από έτοιμο image, μπορείς να αλλάξεις τους πόρους και τις μεταβλητές της.
- Τα δεδομένα της κρατιούνται στον φάκελο δεδομένων της υπηρεσίας, στον δίσκο της.
Τι δεν έχει:
- Ένας broker — χωρίς replication· κάθε topic έχει replication factor 1.
- Χωρίς διαχειριζόμενα backup του Kafka. Το ημερήσιο backup αντιγράφει τον φάκελο δεδομένων του ως αρχεία ενώ το Kafka τρέχει. Αυτό δεν είναι συνεπές backup του Kafka: μετά από μια ανάκτηση μπορεί να λείπουν πρόσφατα μηνύματα ή το Kafka να χρειαστεί να ανακτήσει τα logs του κατά την εκκίνηση.
- Χωρίς χρόνο συντήρησης, χωρίς πρόσβαση από έξω και χωρίς Kafka UI.
- Η αναβάθμιση του Kafka είναι δική σου υπόθεση: άλλαξε το image στις Ρυθμίσεις της υπηρεσίας.
Για ουρές και συμβάντα με backup και έτοιμες μεταβλητές σύνδεσης, δες Συμβάντα και ουρές — NATS και RabbitMQ.
Επικοινωνία με το όνομα
Οι υπηρεσίες ενός project επικοινωνούν σε ιδιωτικό δίκτυο με το όνομά τους: μια υπηρεσία με όνομα api είναι προσβάσιμη από τις άλλες ως api, μια βάση δεδομένων με όνομα db ως db, και η κύρια υπηρεσία ως web. Η κίνηση ανάμεσα στις υπηρεσίες ενός project δεν μετράει ως κίνηση.
Κάθε web υπηρεσία δείχνει την Εσωτερική διεύθυνσή της — για παράδειγμα http://api:8080 — και οι άλλες υπηρεσίες την παίρνουν σε μια μεταβλητή, RIVERVO_API_URL. Πώς λειτουργεί, υπηρεσίες μόνο εσωτερικές, πολλά instances και timeouts: Επικοινωνία μεταξύ υπηρεσιών.
Κάθε υπηρεσία παίρνει τις μεταβλητές του project — μαζί με τη σύνδεση στη βάση δεδομένων — συν τις δικές της μεταβλητές, που έχουν προτεραιότητα έναντι του project. Δες Μεταβλητές περιβάλλοντος.
Πόροι και τιμή
Κάθε υπηρεσία έχει δική της Μνήμη, CPU και Δίσκο, με τιμή όπως κάθε εφαρμογή: 6,77 € ανά GB μνήμης και 4,51 € ανά πυρήνα CPU τον μήνα, με 10 GB δίσκου να περιλαμβάνονται ανά GB μνήμης, και μετά 0,17 € ανά GB. Μια υπηρεσία μπορεί να έχει έως 8 GB μνήμης.
Όταν προσθέτεις μια υπηρεσία, η τιμή της προστίθεται στη χρέωση του project — για τον τρέχοντα μήνα μόνο το υπόλοιπο μέρος του. Όσο το project είναι σε δωρεάν δοκιμή, οι νέες υπηρεσίες είναι δωρεάν μέχρι να λήξει η δοκιμή.
Η Επισκόπηση δείχνει το Σύνολο project — πόσο κοστίζουν όλες οι υπηρεσίες του project μαζί τον μήνα.
Workers μέσα στην ίδια την εφαρμογή
Δεν χρειάζεσαι πάντα ξεχωριστή υπηρεσία. Η καρτέλα Διεργασίες της κύριας εφαρμογής έχει:
- Background workers — έως 5 διεργασίες μεγάλης διάρκειας δίπλα στην ιστοσελίδα, π.χ. έναν queue worker. Μοιράζονται τους πόρους της εφαρμογής και κάνουν επανεκκίνηση με κάθε deploy.
- Προγραμματισμένες εντολές — έως 10 εντολές με χρονοπρογραμματισμό (μορφή cron, UTC). Η έξοδός τους βρίσκεται στο log, στον Χρονοπρογραμματισμό.
- Κονσόλα — εκτέλεσε μια εφάπαξ εντολή μέσα στην εφαρμογή που τρέχει, με τις μεταβλητές και τη βάση δεδομένων της. Μια εντολή μπορεί να τρέχει έως 15 λεπτά· διαδραστικές εντολές (tinker, shell) δεν υποστηρίζονται εδώ.
Μια ξεχωριστή υπηρεσία είναι καλύτερη επιλογή όταν ένας worker χρειάζεται δικούς του πόρους, ώστε μια βαριά ουρά να μην επιβραδύνει ποτέ την ιστοσελίδα.
Αλλαγή υπηρεσίας
Άνοιξε την υπηρεσία από τη λίστα Υπηρεσίες. Οι Ρυθμίσεις της περιέχουν την εντολή, τον χρονοπρογραμματισμό, το image ή το branch, και τους πόρους της· οι αλλαγές αποθηκεύονται και η υπηρεσία κάνει επανεκκίνηση με αυτές. Κάθε υπηρεσία έχει επίσης δικά της Logs και Παρακολούθηση.