Déployer un site PRISM

Le déploiement d'un site PRISM se fait en trois temps : builder et vérifier l'application avec la CLI bext, la mettre en ligne sur un nom d'hôte, puis itérer grâce au rechargement à chaud. Pour le choix du sous-domaine ou d'un domaine personnalisé, voir Provisionnement de sous-domaines.

1. Builder et vérifier en local

Produisez le bundle de production dans dist/ :

bext build

Vérifiez ensuite le résultat comme il sera servi, en une commande (détection du framework, build et service) :

bext run .

Pour contrôler les routes découvertes avant la mise en ligne :

bext routes

Voir la Référence CLI pour les options de chaque commande.

2. Mettre en ligne

Sur Inklura, les noms d'hôte du site se gèrent depuis la console :

  • son sous-domaine *.inklura.fr ne demande aucune modification DNS et il est servi en HTTPS avec un certificat géré par la plateforme ;
  • un domaine personnalisé s'ajoute dans la page Domaines de la console et demande un enregistrement DNS pointant vers la plateforme ; une fois la vérification DNS réussie, le certificat et le routage sont préparés. Le détail se trouve dans Provisionnement de sous-domaines.

3. Rechargement à chaud

Avec live_reload = true et vos sources listées dans [build] watch_dirs, toute modification d'un fichier de ces répertoires est prise en compte en une ou deux secondes, sans nouveau déploiement. live_reload vaut false par défaut, et une liste watch_dirs vide désactive la surveillance :

[build]
watch_dirs = ["src/app", "src/components", "src/lib"]
live_reload = true

Les enregistrements rapprochés sont regroupés sur debounce_ms (200 ms par défaut). Un nouveau page.tsx ou route.ts dans watch_dirs est lui aussi pris en compte : la table des routes est rafraîchie quand le fichier apparaît.

Ce que le rechargement ne couvre pas

Les fichiers hors de watch_dirs ne sont pas surveillés : listez chaque répertoire de sources que vous modifiez (src/lib compris). Les répertoires absents du site sont ignorés.

Note

public/islands/* ne fait pas partie de watch_dirs. Pour forcer le rechargement d'un script d'island dans le navigateur, incrémentez un paramètre ?v= sur son <script src>.

En local

bext dev surveille watch_dirs sans avoir besoin de live_reload ; si la liste est vide, il surveille le dossier de l'application. bext routes relit les fichiers à chaque appel : si une route y figure mais que bext dev ne la sert pas, redémarrez bext dev.

Voir aussi