Communication entre services : adresses internes et services internes uniquement.
Comment les services d'une même application se joignent par l'adresse interne, les variables RIVERVO_<NAME>_URL, les services sans adresse publique, les instances multiples, ainsi que les délais d'attente et les nouvelles tentatives, avec des exemples pour Node.js, Laravel et Python.
Les services d'une même application communiquent directement entre eux, sans passer par Internet. Un site peut appeler sa propre API, un worker peut appeler un service interne — et ce trafic est gratuit : il n'est pas compté comme trafic.
Les exemples ci-dessous utilisent deux services web : web, le site qu'ouvrent les visiteurs, avec une Adresse publique, et api, que seuls web et les autres services appellent, réglé sur Interne uniquement.
L'adresse interne
Chaque service web — avec une adresse publique ou en interne uniquement — a une Adresse interne de la forme http://<service-name>:<port>, par exemple http://api:8080. Elle s'affiche sur la page du service et dans la Vue d'ensemble de l'application, avec un bouton de copie et l'indication « Les autres services de cette application le joignent ici — sans Internet, sans frais de trafic. »
- Le port est 8080 pour un service construit à partir d'un dépôt, ou le Port que vous avez indiqué pour un service issu d'une image prête à l'emploi.
- Seuls les services de la même application peuvent joindre cette adresse. Elle n'est accessible ni depuis Internet, ni depuis d'autres applications.
- L'adresse utilise
http://. La connexion reste à l'intérieur de l'application : il n'y a donc aucun certificat à configurer.
Les variables avec les adresses
Inutile de copier les adresses dans votre code. Chaque service de code de l'application — services web, workers en arrière-plan et tâches planifiées — reçoit une variable avec l'adresse interne de chacun des autres services web de l'application :
RIVERVO_<NAME>_URL=http://<name>:<port>
NAME est le nom du service en majuscules, les tirets étant remplacés par _ :
| Service | Variable |
|---|---|
api | RIVERVO_API_URL=http://api:8080 |
admin-api | RIVERVO_ADMIN_API_URL=http://admin-api:8080 |
web | RIVERVO_WEB_URL=http://web:8080 |
search (image prête à l'emploi, port 7700) | RIVERVO_SEARCH_URL=http://search:7700 |
- Un service ne reçoit pas de variable pour lui-même.
- Les bases de données et Valkey gardent leur propre
RIVERVO_<NAME>_URLavec l'adresse de connexion. Les noms de services sont uniques au sein d'une application : les noms n'entrent donc jamais en conflit. - Les variables figurent dans l'onglet Variables, parmi les variables Définies automatiquement. Comme pour toute variable automatique, une variable que vous définissez vous-même (ou une variable partagée) portant le même nom prend sa place — voir Variables d'environnement.
- Les variables arrivent dans un service à son prochain déploiement. Lorsque vous ajoutez ou renommez un service web, les autres services reçoivent la variable nouvelle ou modifiée à leur prochain déploiement. Redéployez-les pour qu'ils la prennent en compte, par exemple avec
rivervo deploy <app> --no-build: la version en cours redémarre avec les nouvelles variables, sans nouveau build.
Services internes uniquement
Un service web que seuls les autres services de l'application appellent — une API derrière votre site, un back-office d'administration, un moteur de recherche — n'a pas besoin d'être sur Internet. Réglez-le sur Interne uniquement :
| Adresse publique | Interne uniquement | |
|---|---|---|
Adresse sur Internet https://<name>.rivervo.app | oui | non |
| Vos propres domaines | oui | non |
| Aperçus de branche | oui | non |
| Adresse interne pour les autres services | oui | oui |
| Instances multiples et mise à l'échelle automatique, logs, monitoring, vérifications de santé | oui | oui |
Un service interne uniquement fonctionne comme n'importe quel autre service ; seuls les autres services de la même application peuvent le joindre.
Choisir à la création d'un service
Lorsque vous créez un service web — y compris le premier service d'une nouvelle application, à partir d'un dépôt, d'un modèle ou d'une image prête à l'emploi —, choisissez Adresse publique ou Interne uniquement. Rien n'est présélectionné : le choix vous revient toujours. Les workers en arrière-plan, les tâches planifiées et les bases de données n'ont jamais d'adresse publique : il n'y a donc pas de choix à faire pour eux.
Les services créés avant l'apparition de ce choix conservent leur adresse publique.
Changer plus tard
Le service → Paramètres → Adresse publique : basculez l'interrupteur et confirmez. Seul un Administrateur de l'application ou le propriétaire du compte peut le modifier. Rien ne redémarre.
- Le passage en interne uniquement est refusé tant que des domaines sont connectés au service — retirez-les d'abord dans son onglet Domaines. Les aperçus doivent aussi être désactivés au préalable.
- Réactiver l'adresse publique redonne au service la même adresse
https://<name>.rivervo.app. Le certificat peut prendre environ une minute. - L'ajout d'un domaine à un service interne uniquement est refusé — activez d'abord son adresse publique.
L'onglet Terminal fonctionne dans un service interne uniquement exactement comme dans n'importe quel autre.
Communication asynchrone
Les appels ci-dessus attendent une réponse. Lorsqu'un service doit confier du travail et poursuivre — tâches en arrière-plan, événements auxquels plusieurs services réagissent —, envoyez plutôt des messages via une file d'attente ou un broker de messages : Valkey, NATS ou RabbitMQ. Voir Événements et files d'attente.
Instances multiples
Lorsque le service que vous appelez tourne sur plusieurs instances, son nom interne mène à toutes ses instances en cours d'exécution, et les connexions sont réparties entre elles.
Un client qui garde ses connexions ouvertes et les réutilise (un pool de connexions keep-alive) peut continuer d'envoyer ses requêtes à la même instance ; les nouvelles connexions sont à nouveau réparties. C'est normal et ne demande aucune configuration.
Délais d'attente et nouvelles tentatives
Pendant un déploiement, ou quand la mise à l'échelle automatique arrête une instance, une requête en cours peut échouer. Deux bonnes pratiques rendent les appels entre services fiables :
- Un délai d'attente court — quelques secondes, pour qu'un appel ne reste jamais bloqué pendant que l'instance visée s'arrête.
- Une ou deux nouvelles tentatives avec une courte pause, pour les requêtes qui peuvent être répétées sans risque — la lecture de données avec
GET. Ne répétez pas les requêtes qui modifient des données (paiements, commandes), sauf si votre API sait distinguer une requête répétée d'une nouvelle.
Exemple : 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()Exemple : Laravel
Placez l'adresse dans config/services.php :
'api' => [
'url' => env('RIVERVO_API_URL'),
],Lisez-la ensuite avec config(). En production, la configuration est mise en cache, et env() appelé en dehors des fichiers de configuration ne renvoie rien :
use Illuminate\Support\Facades\Http;
$orders = Http::timeout(5)
->retry(2, 200)
->get(config('services.api.url').'/orders')
->json();timeout(5) attend au maximum 5 secondes ; retry(2, 200) fait jusqu'à 2 tentatives espacées de 200 ms.
Exemple : Python
import os
import requests
API = os.environ["RIVERVO_API_URL"]
orders = requests.get(f"{API}/orders", timeout=5).json()Avec de nouvelles tentatives pour 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()Un GET qui échoue — erreur de connexion ou réponse 502, 503 ou 504 — est répété jusqu'à 2 fois, avec une courte pause qui s'allonge à chaque fois.
En ligne de commande et avec Rivervo MCP
rivervo appset le détail des services affichent l'adresse interne de chaque service web et indiquent s'il a une adresse publique.rivervo services set-public <service> on|offactive ou désactive l'adresse publique. Il faut le rôle Administrateur et un jeton avec Accès complet.- Dans Rivervo MCP, ce même réglage correspond à l'outil
set_public_address.
Voir Outils pour les développeurs pour les jetons et la ligne de commande.