Comunicación entre servicios: direcciones internas y servicios solo internos.
Cómo se comunican los servicios de una aplicación a través de la dirección interna, las variables RIVERVO_<NAME>_URL, los servicios sin dirección pública, las instancias múltiples, y los tiempos de espera y reintentos con ejemplos para Node.js, Laravel y Python.
Los servicios de una aplicación se comunican entre sí directamente, sin pasar por internet. Un sitio puede llamar a su propia API, un worker puede llamar a un servicio interno, y este tráfico es gratis: no se cuenta como tráfico.
Los ejemplos de abajo usan dos servicios web: web, el sitio que abren los visitantes, con Dirección pública, y api, al que solo llaman web y los demás servicios, configurado como Solo interno.
La dirección interna
Cada servicio web —con dirección pública o solo interno— tiene una Dirección interna con el formato http://<service-name>:<port>, por ejemplo http://api:8080. Se muestra en la página del servicio y en el Resumen de la aplicación, con un botón para copiarla y el aviso «Los demás servicios de esta aplicación llegan a él aquí: sin internet y sin cargos por tráfico.»
- El puerto es 8080 en un servicio compilado desde un repositorio, o el Puerto que hayas indicado en un servicio de una imagen lista.
- Solo los servicios de la misma aplicación pueden llegar a esta dirección. No se abre desde internet ni desde otras aplicaciones.
- La dirección usa
http://. La conexión no sale de la aplicación, así que no hay ningún certificado que configurar.
Variables con las direcciones
No necesitas copiar las direcciones en tu código. Cada servicio de código de la aplicación —servicios web, workers en segundo plano y tareas programadas— recibe una variable con la dirección interna de cada uno de los demás servicios web de la aplicación:
RIVERVO_<NAME>_URL=http://<name>:<port>
NAME es el nombre del servicio en mayúsculas, con los guiones convertidos en _:
| Servicio | 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 (de una imagen lista, puerto 7700) | RIVERVO_SEARCH_URL=http://search:7700 |
- Un servicio no recibe una variable para sí mismo.
- Las bases de datos y Valkey conservan su propia
RIVERVO_<NAME>_URLcon la dirección de conexión. Los nombres de los servicios son únicos dentro de una aplicación, así que nunca chocan. - Las variables aparecen en la pestaña Variables, entre las Definidas automáticamente. Como con cualquier variable automática, una variable propia (o una variable compartida) con el mismo nombre ocupa su lugar; consulta Variables de entorno.
- Las variables llegan a un servicio con su siguiente despliegue. Cuando añades un servicio web nuevo o cambias el nombre de uno, los demás servicios reciben la variable nueva o modificada en su siguiente despliegue. Vuelve a desplegarlos para que la tomen, por ejemplo con
rivervo deploy <app> --no-build: inicia de nuevo la versión en ejecución con las nuevas variables, sin una nueva compilación.
Servicios solo internos
Un servicio web al que solo llaman otros servicios de la aplicación —una API detrás de tu sitio, un backend de administración, un motor de búsqueda— no necesita estar en internet. Configúralo como Solo interno:
| Dirección pública | Solo interno | |
|---|---|---|
Dirección en internet https://<name>.rivervo.app | sí | no |
| Tus propios dominios | sí | no |
| Vistas previas de ramas | sí | no |
| Dirección interna para los demás servicios | sí | sí |
| Instancias múltiples y escalado automático, logs, monitorización, comprobaciones de estado | sí | sí |
Un servicio solo interno funciona como cualquier otro servicio; solo pueden llegar a él los demás servicios de la misma aplicación.
Elegir al crear un servicio
Cuando creas un servicio web —también el primer servicio de una aplicación nueva, desde un repositorio, una plantilla o una imagen lista—, elige Dirección pública o Solo interno. No hay nada seleccionado de antemano, así que la decisión siempre es tuya. Los workers en segundo plano, las tareas programadas y las bases de datos nunca tienen dirección pública, así que para ellos no hay elección.
Los servicios creados antes de que existiera esta opción conservan su dirección pública.
Cambiarlo más adelante
En el servicio → Ajustes → Dirección pública: cambia el interruptor y confirma. Solo un Administrador de la aplicación o el propietario de la cuenta puede cambiarlo. No se reinicia nada.
- El paso a solo interno se rechaza mientras el servicio tenga dominios conectados: quítalos antes en su pestaña Dominios. También hay que desactivar antes las vistas previas.
- Volver a activar la dirección pública le devuelve al servicio la misma dirección
https://<name>.rivervo.app. El certificado puede tardar alrededor de un minuto. - Se rechaza añadir un dominio a un servicio solo interno: activa antes su dirección pública.
La pestaña Terminal funciona en un servicio solo interno igual que en cualquier otro.
Comunicación asíncrona
Las llamadas de arriba esperan una respuesta. Cuando un servicio debe pasar un trabajo y seguir con lo suyo —tareas en segundo plano, eventos a los que reaccionan varios servicios—, envía mensajes a través de una cola o un broker de mensajes: Valkey, NATS o RabbitMQ. Consulta Eventos y colas.
Varias instancias
Cuando el servicio al que llamas ejecuta varias instancias, su nombre interno lleva a todas sus instancias en marcha y las conexiones se reparten entre ellas.
Un cliente que mantiene sus conexiones abiertas y las reutiliza (un pool de conexiones keep-alive) puede seguir enviando sus peticiones a la misma instancia; las conexiones nuevas se vuelven a repartir. Es normal y no requiere ninguna configuración.
Tiempos de espera y reintentos
Durante un despliegue, o cuando el escalado automático detiene una instancia, una petición en curso puede fallar. Dos costumbres hacen fiables las llamadas entre servicios:
- Un tiempo de espera corto: unos pocos segundos, para que una llamada nunca se quede colgada mientras se detiene la instancia a la que fue.
- Uno o dos reintentos con una pausa corta, para las peticiones que se pueden repetir sin riesgo: leer datos con
GET. No repitas peticiones que cambian datos (pagos, pedidos) salvo que tu API sepa distinguir una petición repetida de una nueva.
Ejemplo: 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()Ejemplo: Laravel
Pon la dirección en config/services.php:
'api' => [
'url' => env('RIVERVO_API_URL'),
],Después, léela con config(). En producción la configuración está en caché, y env() llamado fuera de los archivos de configuración no devuelve nada:
use Illuminate\Support\Facades\Http;
$orders = Http::timeout(5)
->retry(2, 200)
->get(config('services.api.url').'/orders')
->json();timeout(5) espera como máximo 5 segundos; retry(2, 200) hace hasta 2 intentos con 200 ms entre ellos.
Ejemplo: Python
import os
import requests
API = os.environ["RIVERVO_API_URL"]
orders = requests.get(f"{API}/orders", timeout=5).json()Con reintentos para 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 fallido —un error de conexión o una respuesta 502, 503 o 504— se repite hasta 2 veces, con una pausa corta que crece cada vez.
Desde la línea de comandos y Rivervo MCP
rivervo appsy los detalles del servicio muestran la dirección interna de cada servicio web y si tiene dirección pública.rivervo services set-public <service> on|offactiva o desactiva la dirección pública. Necesita el rol de Administrador y un token con Acceso completo.- En Rivervo MCP, ese mismo cambio es la herramienta
set_public_address.
Consulta Herramientas para desarrolladores para los tokens y la línea de comandos.