Empezar

Servicios de un proyecto: servicios web, workers y tareas programadas.

Añade a un proyecto workers en segundo plano, tareas programadas, más servicios web, bases de datos y Valkey —desde su propio código, otro repositorio o una imagen lista—, accesibles por su nombre y en una sola factura.

6 MIN DE LECTURA

Un proyecto es más que un proceso. Junto a la aplicación principal puedes ejecutar un worker de colas, una tarea nocturna, una API aparte o una base de datos, cada uno como un servicio con sus propios recursos, todo en una sola factura.

Los servicios aparecen en la aplicación, en Resumen → Servicios → Añadir un servicio. Un proyecto puede tener hasta 10 servicios. Primero hay que lanzar el servicio principal, y la suscripción del proyecto debe estar activa (la prueba cuenta).

Tipos de servicios

TipoQué es
Servicio webotro sitio o API, con dirección pública o solo interno
Worker en segundo planofunciona todo el tiempo: colas, Horizon, Celery, consumidores
Tarea programadaarranca según una programación (formato cron, UTC), hace su trabajo y se detiene
PostgreSQL, MySQL, Valkeybases de datos gestionadas; consulta Bases de datos
NATS, RabbitMQbrokers de mensajes para eventos y colas, solo internos; consulta Eventos y colas

Dirección pública o solo interno

Al añadir un servicio web, elige cómo se puede llegar a él; no hay nada seleccionado de antemano:

  • Dirección pública: accesible desde internet en https://<name>.rivervo.app; puede tener tus propios dominios.
  • Solo interno: sin dirección en internet y sin dominios; solo llegan a él los demás servicios de la aplicación. Ideal para una API detrás de tu sitio, un backend de administración o un motor de búsqueda.

Los workers en segundo plano, las tareas programadas y las bases de datos nunca son públicos, así que para ellos no hay elección. Puedes cambiarlo más adelante en Ajustes → Dirección pública del servicio; consulta Comunicación entre servicios.

De dónde sale el código

El código de este proyecto

El mismo código, iniciado de otra forma: un worker de colas, un planificador, un servidor WebSocket (por ejemplo, Laravel Reverb), una carpeta de un monorepo, una API aparte.

  • El Comando es obligatorio: lo que ejecuta el servicio, por ejemplo php artisan queue:work o node worker.js.
  • Un servicio web debe escuchar en el puerto de $PORT.
  • Una tarea programada necesita además una Programación en formato cron (UTC), por ejemplo */5 * * * *.
  • Cada nueva versión del servicio principal se despliega también en estos servicios, así que siempre ejecutan el mismo código.

Otro repositorio

Un servicio web o un worker en segundo plano desde otro repositorio de tu cuenta de Git conectada, con su propia rama y, si hace falta, Carpeta del proyecto y Comandos de compilación e inicio (deja un campo vacío para usar lo que detectemos). Tiene sus propios despliegues y versiones, y despliega cada push a su rama. Por ahora no se crean vistas previas de ramas para los servicios.

Una imagen lista

Un servicio web o un worker en segundo plano desde una imagen lista (imagen de Docker) en Docker Hub, GitHub Container Registry o cualquier otro registro, por ejemplo nginx:1.27 o ghcr.io/org/app:tag.

  • Puerto: el puerto en el que escucha la imagen; también te lo pasamos en $PORT.
  • Comando: opcional; si está vacío, la imagen se inicia tal como está construida.
  • Registro privado: un nombre de usuario y una contraseña o un token de acceso. Se guardan cifrados, solo se usan para descargar la imagen y no se vuelven a mostrar.
  • Con los despliegues automáticos activados, comprobamos una vez al día si la etiqueta apunta a una versión más nueva y la desplegamos. Volver a descargar la imagen en la pestaña Despliegues lo hace al momento.

Kafka (plantilla)

Kafka en Añadir un servicio es un preajuste de un clic: crea un servicio a partir de la imagen oficial de Apache Kafka (3.9), con un único broker en modo KRaft, sin ZooKeeper. Sirve para desarrollo y cargas moderadas.

  • Solo interno: sin dirección pública y sin acceso desde fuera; solo llegan a él los servicios de la aplicación.
  • Los demás servicios de código de la aplicación reciben KAFKA_BROKERS=<service name>:9092 y RIVERVO_<NAME>_URL=<service name>:9092.
  • Los topics se crean automáticamente la primera vez que se usan.
  • Empieza con 1 GB de memoria · 1 núcleo de CPU · 10 GB de disco. Como cualquier servicio de una imagen lista, puedes cambiar sus recursos y variables.
  • Sus datos se guardan en la carpeta de datos del servicio, en su disco.

Lo que no tiene:

  • Un solo broker: sin replicación; cada topic tiene un factor de replicación de 1.
  • Sin copias de seguridad gestionadas de Kafka. La copia de seguridad diaria copia su carpeta de datos como archivos mientras Kafka está en marcha. No es una copia de seguridad coherente de Kafka: tras una restauración pueden faltar los mensajes más recientes, o Kafka puede tener que recuperar sus logs al arrancar.
  • Sin ventana de mantenimiento, sin acceso desde fuera y sin interfaz de Kafka.
  • Actualizar Kafka es cosa tuya: cambia la imagen en los Ajustes del servicio.

Para colas y eventos con copias de seguridad y variables de conexión ya configuradas, consulta Eventos y colas: NATS y RabbitMQ.

Llegar a otros servicios por su nombre

Los servicios de un proyecto se comunican por una red privada usando su nombre: un servicio llamado api es accesible desde los demás como api, una base de datos llamada db como db y el servicio principal como web. El tráfico entre los servicios de un proyecto no cuenta como tráfico.

Cada servicio web muestra su Dirección interna —por ejemplo, http://api:8080— y los demás servicios la reciben en una variable, RIVERVO_API_URL. Cómo funciona, los servicios solo internos, las instancias múltiples y los tiempos de espera: Comunicación entre servicios.

Cada servicio recibe las variables del proyecto —incluida la conexión a la base de datos— y además sus propias variables, que tienen prioridad sobre las del proyecto. Consulta Variables de entorno.

Recursos y precio

Cada servicio tiene su propia Memoria, CPU y Disco, con el mismo precio que cualquier aplicación: 6,61 € por GB de memoria y 4,40 € por núcleo de CPU al mes, con 10 GB de disco incluidos por cada GB de memoria y después 0,17 € por GB. Un servicio puede tener hasta 8 GB de memoria.

Cuando añades un servicio, su precio se suma a la factura del proyecto; en el mes en curso, solo la parte que queda. Mientras el proyecto está en su prueba gratuita, los servicios nuevos son gratis hasta que termine la prueba.

El Resumen muestra el Total del proyecto: lo que cuestan al mes todos los servicios del proyecto juntos.

Workers dentro de la propia aplicación

No siempre necesitas un servicio aparte. La pestaña Procesos de la aplicación principal tiene:

  • Workers en segundo plano: hasta 5 procesos de larga duración junto al sitio, por ejemplo un worker de colas. Comparten los recursos de la aplicación y se reinician con cada despliegue.
  • Comandos programados: hasta 10 comandos según una programación (formato cron, UTC). Su salida está en el log, en Programación.
  • Consola: ejecuta un comando puntual dentro de la aplicación en marcha, con sus variables y su base de datos. Un comando puede durar hasta 15 minutos; aquí no se admiten comandos interactivos (tinker, una shell).

Un servicio aparte es mejor opción cuando un worker necesita sus propios recursos, para que una cola pesada nunca ralentice el sitio.

Cambiar un servicio

Abre el servicio desde la lista Servicios. Sus Ajustes contienen el comando, la programación, la imagen o la rama, y sus recursos; los cambios se guardan y el servicio se reinicia con ellos. Cada servicio tiene además sus propios Logs y su Monitorización.

¿Sigues con dudas?

Escríbenos por chat: la AI responde al momento y un ingeniero se une cuando hace falta, a cualquier hora del día.

Contactar con soporte