Bases, stockage, routing

URLs et routing

Domaines, sous-domaines et HttpRoutes : comment Wakastart route le trafic HTTP vers tes services.

Version v1.01 min de lecture

URLs et routing

📍 Où trouver ça dans l'UI

Domaines et HttpRoutes de l'app : Infra → onglet Architecture → URLs

URLs réelles par env : Infra → Environments → {env} → URLs

Comment tes utilisateurs accèdent à ton app ?

Wakastart gère le routing HTTP de bout en bout : DNS → load balancer → service.

Domaines (App Domain)

Type	Exemple	Source
PLATFORM_MANAGED	`*.wakastart.app`	Géré par Wakastart, certificats SSL auto, gratuit
CUSTOM	`exemple.com`	Tu apportes ton domaine, tu délègues la gestion du DNS chez Wakastart

App URL = sous-domaine + (préfixe d'env) + domaine

Le pattern d'URL Wakastart insère le slug de l'environnement comme préfixe entre le sous-domaine et le domaine racine — sauf pour la prod, qui n'a pas de préfixe.

text
prod  →  sous-domaine "app"  +  domaine "exemple.com"            =  https://app.exemple.com
dev   →  sous-domaine "app"  +  préfixe env "dev"  +  domaine    =  https://app.dev.exemple.com

HttpRoute = routing interne d'une URL

À une URL on attache une HttpRoute qui dit "envoie tout /api/* vers le ServiceInstance backend, tout / vers le ServiceInstance frontend". C'est du routage applicatif (équivalent d'un reverse proxy nginx, mais déclaratif).

text
https://app.dev.exemple.com/api/users
            ↓
   Gateway Wakastart
            ↓
   Match HttpRoute path /api/*
            ↓
   Forward vers ServiceInstance "backend"
            ↓
   Pod backend renvoie 200 OK