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

CibleCréée parServie sur
Previewvercel deploySon URL de déploiement, et les domaines de branche qui la suivent.
Productionvercel deploy --prodSon 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

StatutAPISignification
En fileQUEUEDLe déploiement attend son tour de publication.
Build en coursBUILDINGLe build tourne dans la CI, ou les fichiers sont en cours de publication.
PrêtREADYLe site est en ligne sur son URL.
ErreurERRORLe build ou la publication a échoué. Le message est sur la page du déploiement.
AnnuléCANCELEDAnnulé 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.