Ξεκίνα

Επικοινωνία μεταξύ υπηρεσιών: εσωτερικές διευθύνσεις και υπηρεσίες μόνο εσωτερικές.

Πώς οι υπηρεσίες μιας εφαρμογής επικοινωνούν μέσω της εσωτερικής διεύθυνσης, οι μεταβλητές RIVERVO_<NAME>_URL, υπηρεσίες χωρίς δημόσια διεύθυνση, πολλά instances, και timeouts και επαναλήψεις με παραδείγματα για Node.js, Laravel και Python.

6 ΛΕΠΤΑ ΑΝΑΓΝΩΣΗΣ

Οι υπηρεσίες μιας εφαρμογής επικοινωνούν απευθείας μεταξύ τους, χωρίς να περνούν από το internet. Μια ιστοσελίδα μπορεί να καλεί το δικό της API, ένας worker μπορεί να καλεί μια εσωτερική υπηρεσία — και αυτή η κίνηση είναι δωρεάν: δεν μετράει ως κίνηση.

Τα παρακάτω παραδείγματα χρησιμοποιούν δύο web υπηρεσίες: τη web, την ιστοσελίδα που ανοίγουν οι επισκέπτες, με Δημόσια διεύθυνση, και την api, που την καλούν μόνο η web και οι άλλες υπηρεσίες, ρυθμισμένη ως Μόνο εσωτερική.

Η εσωτερική διεύθυνση

Κάθε web υπηρεσία — με δημόσια διεύθυνση ή μόνο εσωτερική — έχει μια Εσωτερική διεύθυνση της μορφής http://<service-name>:<port>, για παράδειγμα http://api:8080. Εμφανίζεται στη σελίδα της υπηρεσίας και στην Επισκόπηση της εφαρμογής, με κουμπί αντιγραφής και την υπόδειξη «Οι άλλες υπηρεσίες αυτής της εφαρμογής φτάνουν εδώ — χωρίς internet, χωρίς χρέωση κίνησης.»

  • Η θύρα είναι 8080 για υπηρεσία που χτίζεται από repository, ή η Θύρα που όρισες για υπηρεσία από έτοιμο image.
  • Μόνο οι υπηρεσίες της ίδιας εφαρμογής φτάνουν σε αυτή τη διεύθυνση. Δεν ανοίγει από το internet ούτε από άλλες εφαρμογές.
  • Η διεύθυνση χρησιμοποιεί http://. Η σύνδεση μένει μέσα στην εφαρμογή, οπότε δεν χρειάζεται να ρυθμίσεις πιστοποιητικό.

Μεταβλητές με τις διευθύνσεις

Δεν χρειάζεται να αντιγράψεις τις διευθύνσεις στον κώδικά σου. Κάθε υπηρεσία κώδικα της εφαρμογής — web υπηρεσίες, background workers και προγραμματισμένες εργασίες — παίρνει μια μεταβλητή με την εσωτερική διεύθυνση κάθε άλλης web υπηρεσίας της εφαρμογής:

RIVERVO_<NAME>_URL=http://<name>:<port>

Το NAME είναι το όνομα της υπηρεσίας με κεφαλαία γράμματα, με τις παύλες να γίνονται _:

ΥπηρεσίαΜεταβλητή
apiRIVERVO_API_URL=http://api:8080
admin-apiRIVERVO_ADMIN_API_URL=http://admin-api:8080
webRIVERVO_WEB_URL=http://web:8080
search (από έτοιμο image, θύρα 7700)RIVERVO_SEARCH_URL=http://search:7700
  • Μια υπηρεσία δεν παίρνει μεταβλητή για τον εαυτό της.
  • Οι βάσεις δεδομένων και το Valkey κρατούν το δικό τους RIVERVO_<NAME>_URL με τη διεύθυνση σύνδεσης. Τα ονόματα υπηρεσιών είναι μοναδικά μέσα σε μια εφαρμογή, οπότε τα ονόματα δεν συγκρούονται ποτέ.
  • Οι μεταβλητές εμφανίζονται στην καρτέλα Μεταβλητές ανάμεσα σε αυτές που Ορίζονται αυτόματα. Όπως με κάθε αυτόματη μεταβλητή, μια δική σου μεταβλητή (ή μια κοινόχρηστη μεταβλητή) με το ίδιο όνομα παίρνει τη θέση της — δες Μεταβλητές περιβάλλοντος.
  • Οι μεταβλητές φτάνουν σε μια υπηρεσία με το επόμενο deploy της. Όταν προσθέτεις μια νέα web υπηρεσία ή μετονομάζεις μία, οι άλλες υπηρεσίες παίρνουν τη νέα ή αλλαγμένη μεταβλητή στο επόμενο deploy τους. Κάνε τους ξανά deploy για να την πάρουν, για παράδειγμα με rivervo deploy <app> --no-build — ξεκινά ξανά την έκδοση που τρέχει με τις νέες μεταβλητές, χωρίς νέο build.

Υπηρεσίες μόνο εσωτερικές

Μια web υπηρεσία που την καλούν μόνο άλλες υπηρεσίες της εφαρμογής — ένα API πίσω από την ιστοσελίδα σου, ένα διαχειριστικό backend, μια μηχανή αναζήτησης — δεν χρειάζεται να είναι στο internet. Ρύθμισέ τη ως Μόνο εσωτερική:

Δημόσια διεύθυνσηΜόνο εσωτερική
Διεύθυνση στο internet https://<name>.rivervo.appναιόχι
Δικά σου domainναιόχι
Previews ανά branchναιόχι
Εσωτερική διεύθυνση για τις άλλες υπηρεσίεςναιναι
Πολλά instances και αυτόματη κλιμάκωση, logs, παρακολούθηση, health checksναιναι

Μια υπηρεσία μόνο εσωτερική τρέχει όπως κάθε άλλη υπηρεσία· απλώς μόνο οι άλλες υπηρεσίες της ίδιας εφαρμογής φτάνουν σε αυτήν.

Επιλογή κατά τη δημιουργία υπηρεσίας

Όταν δημιουργείς μια web υπηρεσία — και την πρώτη υπηρεσία μιας νέας εφαρμογής, από repository, πρότυπο ή έτοιμο image — επίλεξε Δημόσια διεύθυνση ή Μόνο εσωτερική. Τίποτα δεν είναι προεπιλεγμένο, οπότε η επιλογή είναι πάντα δική σου. Οι background workers, οι προγραμματισμένες εργασίες και οι βάσεις δεδομένων δεν έχουν ποτέ δημόσια διεύθυνση, οπότε για αυτές δεν υπάρχει επιλογή.

Οι υπηρεσίες που δημιουργήθηκαν πριν υπάρξει αυτή η επιλογή κρατούν τη δημόσια διεύθυνσή τους.

Αλλαγή αργότερα

Η υπηρεσία → Ρυθμίσεις → Δημόσια διεύθυνση: γύρνα τον διακόπτη και επιβεβαίωσε. Μόνο ένας Διαχειριστής της εφαρμογής ή ο κάτοχος του λογαριασμού μπορεί να το αλλάξει. Τίποτα δεν κάνει επανεκκίνηση.

  • Η αλλαγή σε μόνο εσωτερική απορρίπτεται όσο η υπηρεσία έχει συνδεδεμένα domain — αφαίρεσέ τα πρώτα στην καρτέλα Domains της. Πρέπει πρώτα να απενεργοποιηθούν και τα previews.
  • Η επανενεργοποίηση της δημόσιας διεύθυνσης δίνει στην υπηρεσία την ίδια διεύθυνση https://<name>.rivervo.app. Το πιστοποιητικό μπορεί να χρειαστεί περίπου ένα λεπτό.
  • Η προσθήκη domain σε υπηρεσία μόνο εσωτερική απορρίπτεται — ενεργοποίησε πρώτα τη δημόσια διεύθυνσή της.

Η καρτέλα Τερματικό λειτουργεί σε μια υπηρεσία μόνο εσωτερική όπως και σε κάθε άλλη.

Ασύγχρονη επικοινωνία

Οι κλήσεις παραπάνω περιμένουν απάντηση. Όταν μια υπηρεσία πρέπει να παραδώσει μια δουλειά και να συνεχίσει — εργασίες στο παρασκήνιο, συμβάντα στα οποία αντιδρούν πολλές υπηρεσίες — στείλε μηνύματα μέσω ουράς ή message broker: Valkey, NATS ή RabbitMQ. Δες Συμβάντα και ουρές.

Πολλά instances

Όταν η υπηρεσία που καλείς τρέχει πολλά instances, το εσωτερικό της όνομα οδηγεί σε όλα τα instances της που τρέχουν και οι συνδέσεις μοιράζονται ανάμεσά τους.

Ένας client που κρατά τις συνδέσεις του ανοιχτές και τις ξαναχρησιμοποιεί (keep-alive connection pool) μπορεί να συνεχίσει να στέλνει τα αιτήματά του στο ίδιο instance· οι νέες συνδέσεις μοιράζονται ξανά. Αυτό είναι φυσιολογικό και δεν χρειάζεται ρύθμιση.

Timeouts και επαναλήψεις

Κατά τη διάρκεια ενός deploy, ή όταν η αυτόματη κλιμάκωση σταματά ένα instance, ένα αίτημα που βρίσκεται σε εξέλιξη μπορεί να αποτύχει. Δύο συνήθειες κάνουν αξιόπιστες τις κλήσεις μεταξύ υπηρεσιών:

  • Σύντομο timeout — λίγα δευτερόλεπτα, ώστε μια κλήση να μην κολλάει ποτέ όσο το instance στο οποίο πήγε σταματά.
  • Μία ή δύο επαναλήψεις με μια μικρή παύση, για αιτήματα που μπορούν να επαναληφθούν με ασφάλεια — ανάγνωση δεδομένων με GET. Μην επαναλαμβάνεις αιτήματα που αλλάζουν δεδομένα (πληρωμές, παραγγελίες), εκτός αν το API σου ξεχωρίζει ένα επαναλαμβανόμενο αίτημα από ένα νέο.

Παράδειγμα: Node.js

const api = process.env.RIVERVO_API_URL
 
async function getWithRetry(url, attempts = 3) {
  for (let i = 1; ; i++) {
    try {
      const res = await fetch(url, { signal: AbortSignal.timeout(5000) })
      if (res.status < 500 || i === attempts) return res
    } catch (err) {
      if (i === attempts) throw err
    }
    await new Promise((resolve) => setTimeout(resolve, 200 * i))
  }
}
 
const res = await getWithRetry(`${api}/orders`)
const orders = await res.json()

Παράδειγμα: Laravel

Βάλε τη διεύθυνση στο config/services.php:

'api' => [
    'url' => env('RIVERVO_API_URL'),
],

Μετά διάβασέ τη με config(). Σε παραγωγή οι ρυθμίσεις είναι αποθηκευμένες στην cache, και το env() που καλείται έξω από τα αρχεία ρυθμίσεων δεν επιστρέφει τίποτα:

use Illuminate\Support\Facades\Http;
 
$orders = Http::timeout(5)
    ->retry(2, 200)
    ->get(config('services.api.url').'/orders')
    ->json();

Το timeout(5) περιμένει το πολύ 5 δευτερόλεπτα· το retry(2, 200) κάνει έως 2 προσπάθειες με 200 ms ανάμεσά τους.

Παράδειγμα: Python

import os
import requests
 
API = os.environ["RIVERVO_API_URL"]
 
orders = requests.get(f"{API}/orders", timeout=5).json()

Με επαναλήψεις για GET:

import os
import requests
from requests.adapters import HTTPAdapter
from urllib3.util.retry import Retry
 
API = os.environ["RIVERVO_API_URL"]
 
session = requests.Session()
retry = Retry(total=2, backoff_factor=0.2, allowed_methods=["GET"], status_forcelist=[502, 503, 504])
session.mount("http://", HTTPAdapter(max_retries=retry))
 
orders = session.get(f"{API}/orders", timeout=5).json()

Ένα GET που αποτυγχάνει — σφάλμα σύνδεσης ή απάντηση 502, 503 ή 504 — επαναλαμβάνεται έως 2 φορές, με μια μικρή παύση που μεγαλώνει κάθε φορά.

Από τη γραμμή εντολών και το Rivervo MCP

  • Το rivervo apps και τα στοιχεία της υπηρεσίας δείχνουν την εσωτερική διεύθυνση κάθε web υπηρεσίας και αν έχει δημόσια διεύθυνση.
  • Το rivervo services set-public <service> on|off αλλάζει τη δημόσια διεύθυνση. Χρειάζεται ρόλο Διαχειριστή και token με Πλήρη πρόσβαση.
  • Στο Rivervo MCP ο ίδιος διακόπτης είναι το εργαλείο set_public_address.

Δες Εργαλεία για developers για tokens και τη γραμμή εντολών.

Χρειάζεσαι ακόμα βοήθεια;

Γράψε μας στο chat — το AI απαντά αμέσως και ένας μηχανικός μπαίνει όταν χρειαστεί, οποιαδήποτε ώρα της μέρας.

Επικοινωνία με την υποστήριξη