Concepts
Déploiements
Preview, production, URL, statuts et retour arrière : le cycle de vie d'une version de votre site.
Un déploiement est une version figée de votre site. Il ne change plus après sa publication : une nouvelle version crée un nouveau déploiement, avec sa propre URL.
Preview et production
| Cible | Créée par | Servie sur |
|---|---|---|
| Preview | vercel deploy | Son URL de déploiement, et les domaines de branche qui la suivent. |
| Production | vercel deploy --prod | Son URL de déploiement et les domaines de production du projet. |
Avec l'intégration GitHub, la branche de production part en production et toutes les autres en preview. Le dernier déploiement de production prêt est celui que servent vos domaines.
URL de déploiement
Chaque déploiement reçoit une adresse unique, de la forme https://<projet>-<suffixe>.hgdc.cloud. Elle reste valable tant que le déploiement existe : partagez-la pour faire valider une version avant de la passer en production.
Statuts
| Statut | API | Signification |
|---|---|---|
| En file | QUEUED | Le déploiement attend son tour de publication. |
| Build en cours | BUILDING | Le build tourne dans la CI, ou les fichiers sont en cours de publication. |
| Prêt | READY | Le site est en ligne sur son URL. |
| Erreur | ERROR | Le build ou la publication a échoué. Le message est sur la page du déploiement. |
| Annulé | CANCELED | Annulé depuis la console ou dans GitHub Actions. |
Vue d'ensemble du projet
La vue d'ensemble montre le déploiement de production : un aperçu du site (son image de partage og:image si la page en déclare une, sinon le site lui-même en réduction, s'il accepte d'être affiché dans un cadre), son URL, ses domaines, le commit et son auteur. Le projet prend le favicon de son site. Les previews actives listent la dernière URL de chaque branche.
Actions sur un déploiement
Revenir en arrière
Revenir en arrière remet en ligne un déploiement de production précédent, tout de suite et sans nouveau build. Seul un déploiement prêt peut passer en production.
Redéployer
- Projet relié à GitHub : reconstruit le même commit dans GitHub Actions, avec les variables d'aujourd'hui.
- Projet envoyé par la CLI : republie les fichiers du déploiement choisi, sans rien reconstruire. Pour une nouvelle version, relancez
vercel deploy.
Annuler
Un déploiement en file ou en cours de build peut être annulé. Un déploiement prêt ne s'annule pas : revenez en arrière à la place.
Logs de build
La page de chaque déploiement affiche la sortie du build en direct (installation, vercel build), puis la publication. Cherchez dans les lignes, filtrez les erreurs, ou ouvrez le run GitHub. Voir Logs.