Déploiement local

Le profil local fait tourner toute la plateforme sur un seul poste : le hub et ses services partagés, plus un workspace demo allégé (1 moteur, 1 PostgreSQL, 1 Valkey). C’est l’environnement de développement et de démonstration.

Prérequis

• Docker Desktop avec Docker Compose v2 ou plus récent, 8 Go de mémoire alloués au minimum ;
• Git Bash ou PowerShell 7 ;
• Node 22+ et pnpm (uniquement pour développer le hub, le web ou la doc hors conteneur). Go n’est pas nécessaire : il est exécuté dans l’image golang.

Démarrer

Les fichiers sont dans deploy/local/.

Copy-Item deploy/local/.env.example deploy/local/.env   # mots de passe de développement explicites, jamais de vrai secret
./deploy/local/up.ps1                                   # ou : bash deploy/local/up.sh
./deploy/local/seed.ps1                                 # workspace demo, clé d'API de démo, offres de démonstration

down arrête tout en conservant les volumes ; reset supprime aussi les volumes (données perdues).

Adresses

Service	URL locale
Studio	http://localhost:47020
Console	http://localhost:47021
Documentation (ce site)	http://localhost:47022
Caisse de démo	http://localhost:47023
API hub	http://localhost:47010/v1
Keycloak	http://localhost:47030
Moteur demo (public / management)	http://localhost:47500 / http://localhost:47501
PostgreSQL demo / hub	localhost:47507 / localhost:47040
RabbitMQ (interface)	http://localhost:47051
Silo (console) / Silo sauvegardes	http://localhost:47071 / http://localhost:47073
Grafana / Prometheus	http://localhost:47111 / http://localhost:47110
Uptime Kuma	http://localhost:47112
Mailpit (e-mails de dev)	http://localhost:47130
Traefik (entrée / tableau de bord)	http://localhost:47000 / http://localhost:47002

Toutes les adresses publiées sont dans la plage 47000–47999. Un workspace occupe un créneau de 20 ports : 47500 + slot × 20 (slot 0 = demo, slot 1 = demo-sbx).

Premier ticket

jq .ticket docs-site/src/content/docs/fr/integration/examples/ticket-simple.json \
  | curl -s http://localhost:47500/v1/transactions/simulate \
      -H "X-Api-Key: $RMZ_KEY" -H 'Content-Type: application/json' -d @- | jq .

RMZ_KEY est la clé affichée par le script de seed.

Haute disponibilité simulée

Le profil Compose ha ajoute au workspace demo un second PostgreSQL en réplication (Spilo/Patroni + etcd + HAProxy) pour tester la bascule depuis la console (page Infrastructure du workspace → « Basculer »). Les moteurs passent alors par remizo-demo-pg-rw (HAProxy, port hôte 47510) au lieu de remizo-demo-pg-1.

Nommage

Conteneurs remizo-<slug>-<service>-<n> (remizo-hub-api-1, remizo-demo-engine-1), réseaux remizo-hub-net et remizo-<slug>-net, volumes remizo-<slug>-<service>-<n>-data, base mo_<slug>, bucket Silo mo-<slug>, secrets OpenBao mo/<slug>/….

Développement d’un composant

Démarrez la pile, arrêtez le conteneur du composant à développer, puis lancez-le en local en pointant les services de la pile : pnpm -C hub dev (47010/47011), pnpm -C web dev (47020/47021), pnpm -C docs-site dev (47022), le moteur via l’image golang.