Commencer

Services d'un projet : services web, workers et tâches planifiées.

Ajoutez à un projet des workers en arrière-plan, des tâches planifiées, d'autres services web, des bases de données et Valkey — depuis son propre code, un autre dépôt ou une image prête à l'emploi —, joignables par leur nom et sur une seule facture.

7 MIN DE LECTURE

Un projet, c'est souvent plus qu'un seul processus. À côté de l'application principale, vous pouvez faire tourner un worker de file d'attente, une tâche nocturne, une API séparée, une base de données — chacun comme service avec ses propres ressources, le tout sur une seule facture.

Les services figurent dans la Vue d'ensemble de l'application → Services → Ajouter un service. Un projet peut compter jusqu'à 10 services. Le service principal doit être lancé en premier, et l'abonnement du projet doit être actif (l'essai compte).

Types de services

TypeCe que c'est
Service webun autre site ou une autre API — avec une adresse publique ou en interne uniquement
Worker en arrière-plantourne en permanence : files d'attente, Horizon, Celery, consommateurs
Tâche planifiéedémarre selon un planning (format cron, UTC), fait son travail et s'arrête
PostgreSQL, MySQL, Valkeybases de données gérées — voir Bases de données
NATS, RabbitMQbrokers de messages pour les événements et les files d'attente, en interne uniquement — voir Événements et files d'attente

Adresse publique ou interne uniquement

Lorsque vous ajoutez un service web, choisissez comment il est joignable — rien n'est présélectionné :

  • Adresse publique — accessible depuis Internet à l'adresse https://<name>.rivervo.app ; il peut avoir vos propres domaines.
  • Interne uniquement — pas d'adresse sur Internet ni de domaine ; seuls les autres services de l'application peuvent le joindre. Idéal pour une API derrière votre site, un back-office d'administration ou un moteur de recherche.

Les workers en arrière-plan, les tâches planifiées et les bases de données ne sont jamais publics : il n'y a donc pas de choix à faire pour eux. Vous pouvez modifier ce réglage plus tard dans Paramètres → Adresse publique du service — voir Communication entre services.

D'où vient le code

Le code de ce projet

Le même code, démarré autrement : un worker de file d'attente, un planificateur, un serveur WebSocket (par exemple Laravel Reverb), un dossier d'un monorepo, une API séparée.

  • La Commande est obligatoire — ce que le service exécute, par exemple php artisan queue:work ou node worker.js.
  • Un service web doit écouter sur le port indiqué dans $PORT.
  • Une tâche planifiée a aussi besoin d'un Planning au format cron (UTC), par exemple */5 * * * *.
  • Chaque nouvelle version du service principal est aussi déployée sur ces services : ils exécutent donc toujours le même code.

Un autre dépôt

Un service web ou un worker en arrière-plan issu d'un autre dépôt de votre compte Git connecté, avec sa propre branche et, si besoin, un Dossier du projet et des Commandes de build et de démarrage (laissez un champ vide pour utiliser ce que nous détectons). Il a ses propres déploiements et versions, et déploie chaque push sur sa branche. Les aperçus de branche ne sont pas encore créés pour les services.

Une image prête à l'emploi

Un service web ou un worker en arrière-plan issu d'une image prête à l'emploi (image Docker) sur Docker Hub, GitHub Container Registry ou n'importe quel autre registre — par exemple nginx:1.27 ou ghcr.io/org/app:tag.

  • Port — le port sur lequel l'image écoute ; nous le transmettons aussi dans $PORT.
  • Commande — facultative ; si elle est vide, l'image démarre comme elle a été prévue.
  • Registre privé — un nom d'utilisateur et un mot de passe ou jeton d'accès. Ils sont stockés chiffrés, utilisés uniquement pour télécharger l'image et ne sont plus jamais affichés.
  • Avec les déploiements automatiques activés, nous vérifions une fois par jour si le tag pointe vers une version plus récente et la déployons. Télécharger à nouveau l'image dans l'onglet Déploiements le fait immédiatement.

Kafka (modèle)

Kafka dans Ajouter un service est un préréglage en un clic : il crée un service à partir de l'image officielle Apache Kafka (3.9) — un seul broker en mode KRaft, sans ZooKeeper. Il convient au développement et aux charges modérées.

  • Interne uniquement — pas d'adresse publique ni d'accès depuis l'extérieur ; seuls les services de l'application peuvent le joindre.
  • Les autres services de code de l'application reçoivent KAFKA_BROKERS=<service name>:9092 et RIVERVO_<NAME>_URL=<service name>:9092.
  • Les topics sont créés automatiquement à leur première utilisation.
  • Il démarre avec 1 Go de mémoire · 1 cœur de CPU · 10 Go de disque. Comme pour tout service issu d'une image prête à l'emploi, vous pouvez modifier ses ressources et ses variables.
  • Ses données sont conservées dans le dossier de données du service, sur son disque.

Ce qu'il n'a pas :

  • Un seul broker — pas de réplication ; chaque topic a un facteur de réplication de 1.
  • Pas de sauvegardes Kafka gérées. La sauvegarde quotidienne copie son dossier de données sous forme de fichiers pendant que Kafka tourne. Ce n'est pas une sauvegarde Kafka cohérente : après une restauration, des messages récents peuvent manquer, ou Kafka peut devoir récupérer ses journaux au démarrage.
  • Pas de créneau de maintenance, pas d'accès depuis l'extérieur et pas d'interface Kafka.
  • La mise à jour de Kafka est à votre charge : changez l'image dans les Paramètres du service.

Pour des files d'attente et des événements avec sauvegardes et variables de connexion configurées pour vous, voir Événements et files d'attente — NATS et RabbitMQ.

Se joindre par le nom

Les services d'un projet communiquent sur un réseau privé par leur nom : un service appelé api est joignable depuis les autres sous le nom api, une base de données appelée db sous db, et le service principal sous web. Le trafic entre les services d'un projet n'est pas compté comme trafic.

Chaque service web affiche son Adresse interne — par exemple http://api:8080 — et les autres services la reçoivent dans une variable, RIVERVO_API_URL. Fonctionnement, services internes uniquement, instances multiples et délais d'attente : Communication entre services.

Chaque service reçoit les variables du projet — y compris la connexion à la base de données — ainsi que ses propres variables, qui l'emportent sur celles du projet. Voir Variables d'environnement.

Ressources et prix

Chaque service a ses propres Mémoire, CPU et Disque, facturés comme pour n'importe quelle application : 6,55 € par Go de mémoire et 4,37 € par cœur de CPU et par mois, avec 10 Go de disque inclus par Go de mémoire, puis 0,17 € par Go. Un service peut avoir jusqu'à 8 Go de mémoire.

Quand vous ajoutez un service, son prix s'ajoute à la facture du projet — pour le mois en cours, seulement au prorata de la partie restante. Tant que le projet est en essai gratuit, les nouveaux services sont gratuits jusqu'à la fin de l'essai.

La Vue d'ensemble affiche le Total du projet — le coût mensuel de l'ensemble des services du projet.

Des workers dans l'application elle-même

Un service séparé n'est pas toujours nécessaire. L'onglet Processus de l'application principale propose :

  • Workers en arrière-plan — jusqu'à 5 processus de longue durée à côté du site, par exemple un worker de file d'attente. Ils partagent les ressources de l'application et redémarrent à chaque déploiement.
  • Commandes planifiées — jusqu'à 10 commandes selon un planning (format cron, UTC). Leur sortie se trouve dans le log, sous Planification.
  • Console — lancez une commande ponctuelle dans l'application en cours d'exécution, avec ses variables et sa base de données. Une commande peut durer jusqu'à 15 minutes ; les commandes interactives (tinker, un shell) ne sont pas prises en charge ici.

Un service séparé est préférable lorsqu'un worker a besoin de ses propres ressources, pour qu'une file d'attente chargée ne ralentisse jamais le site.

Modifier un service

Ouvrez le service depuis la liste Services. Ses Paramètres regroupent la commande, le planning, l'image ou la branche, ainsi que ses ressources ; les modifications sont enregistrées et le service redémarre avec elles. Chaque service a aussi ses propres onglets Logs et Monitoring.

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