Commencer

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.

7 MIN DE LECTURE

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 _ :

ServiceVariable
apiRIVERVO_API_URL=http://api:8080
admin-apiRIVERVO_ADMIN_API_URL=http://admin-api:8080
webRIVERVO_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>_URL avec 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 publiqueInterne uniquement
Adresse sur Internet https://<name>.rivervo.appouinon
Vos propres domainesouinon
Aperçus de brancheouinon
Adresse interne pour les autres servicesouioui
Instances multiples et mise à l'échelle automatique, logs, monitoring, vérifications de santéouioui

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 apps et 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|off active 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.

Toujours bloqué ?

Écrivez-nous dans le chat — l'AI répond immédiatement et un ingénieur intervient si besoin, à toute heure.

Contacter l'assistance