Aller au contenu

Aller au sommaire de la doc

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.

Voir en Markdown

Prévisualisation par branche avec ses propres données : une copie temporaire de l’appli et de sa base, à côté de la production, qui disparaît d’elle-même

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 :

while.yaml
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.

Guides

Donnez la phrase à votre IA, elle s’occupe du reste

À donner à votre IA

Lis while.sh/agents et aide-moi à démarrer avec while.

Copier la phrase

En 3 minutes, sans inscription, l’outil a son adresse. Pour le garder, créez votre compte.

Pour un projet d’entreprise, écrivez à l’équipe de while : hello@while.sh