Prévisualisations
Une prévisualisation montre une nouvelle version à son adresse, avec ses propres bases, avant la production. Elle disparaît d’elle-même.
Mis à jour le 21 novembre 2026.
Vous, à votre IA : Montre-moi la nouvelle page avant de la mettre en ligne.
Ce que votre agent écrit
Votre agent l’écrit dans while.yaml, à la racine de votre appli :
apiVersion: while/v1
project: my-app
services:
- name: web
port: 3000
environments:
preview:
from: production
ttl_hours: 24
Quand vous en servir
Servez-vous-en pour essayer une branche avant la production. Avec le widget <script src="/__while/retours.js" defer>, une personne y pointe ce qui ne va pas, et votre agent le lit par list_page_notes.
Comment ça marche
Une prévisualisation reprend l’image de la production, avec ses propres variables, ses bases et son adresse, et disparaît d’elle-même. Ses bases naissent vides, ou copiées de la production sur demande.
Ce qu’il faut savoir
Sans copy_database: true, les bases naissent vides (initdb) : c’est voulu, pas une panne. Copier les données de la production demande create_preview { copy_database: true } et le droit data.backup sur chaque base de la production ; sans ce droit, la réponse est un 403 qui le nomme.
Une base copiée naît de la dernière sauvegarde de la production, journal rejoué jusqu’au dernier point archivé : il faut une minute ou plus selon sa taille. Si la production n’a pas encore de sauvegarde complète, la base naît vide. Les buckets S3 d’une prévisualisation sont neufs et vides, et ttl_hours fixe sa durée de vie, qu’elle soit née de create_preview ou d’un git push. Ses tâches planifiées ne tournent pas à leur heure : run_task les lance à la main, et environments.preview.crons: true les planifie.
Les outils MCP de votre agent
Votre agent s’en occupe avec les outils create_preview et destroy_environment.