---
title: "Prévisualiser avant la production : la doc de while.sh"
url: https://while.sh/fr/docs/briques/preview/
updated: 2026-11-21
---

# 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.

> 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 :

```yaml titre="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

- [Voir chaque nouvelle version avant la production, comme un environnement de recette (2026)](/fr/guides/previsualisation-par-branche/)
