SmartFlow Host

CLI

vercel deploy

Envoyez un dossier ou un build, en preview ou en production.

Sans option, vercel deploy crée une preview avec sa propre URL. Avec --prod, il part en production.

Usage

Terminal
# Preview du dossier courant
vercel --api https://api.host.hgdc.ch --token ah_… deploy

# Production
vercel --api https://api.host.hgdc.ch --token ah_… deploy --prod

La commande affiche l'URL du déploiement, suit le traitement, puis rend la main quand il est prêt ou en erreur. Dans un script, l'URL est écrite seule sur la sortie standard :

Terminal
URL=$(vercel --api https://api.host.hgdc.ch deploy --yes)
echo "Preview : $URL"

Déployer un site statique

Un dossier de HTML, CSS et images part tel quel. Le premier déploiement crée le projet, sous le nom du dossier, et relie le dossier au projet (voir vercel link).

Terminal
cd mon-site
vercel --api https://api.host.hgdc.ch --token ah_… deploy --prod

Déployer un framework

Les sources d'un framework (Astro, Vite, Next.js…) ne sont jamais servies telles quelles. Construisez d'abord avec vercel build, puis envoyez le résultat avec --prebuilt :

Terminal
vercel --api https://api.host.hgdc.ch build --prod
vercel --api https://api.host.hgdc.ch deploy --prebuilt --prod

Options

Options de la commande

--prodboolean
Déploie en production. Le site répond alors sur les domaines de production du projet.
--prebuiltboolean
Envoie le dossier .vercel/output produit par vercel build, sans reconstruire.
--yesboolean
Répond oui aux questions : relie le dossier et crée le projet sans rien demander. Indispensable en CI.
--cwdchemin
Dossier à déployer, si ce n'est pas le dossier courant.
--metaclé=valeur
Métadonnée attachée au déploiement. Le workflow GitHub s'en sert pour rattacher l'envoi au build en cours.

Options globales

Ces deux options s'ajoutent à chaque commande. Elles sont détaillées dans Configurer la CLI.

Options

--apiURLrequis
Adresse de l'API de SmartFlow Host : https://api.host.hgdc.ch.
--tokenstringrequis
Clé d'API, qui commence par ah_. Elle peut aussi venir de la variable VERCEL_TOKEN.

Ce qui se passe

  1. Empreintes

    La CLI calcule l'empreinte SHA1 de chaque fichier et annonce la liste à l'API.

  2. Fichiers manquants

    L'API répond avec les fichiers qu'elle n'a pas encore (missing_files). La CLI les envoie, puis renvoie la liste. Un fichier déjà connu de l'équipe n'est jamais renvoyé : un redéploiement n'envoie que ce qui a changé.

  3. Publication

    Le déploiement est créé, publié, puis passe à l'état READY. La CLI suit les logs de traitement jusqu'à cet état.

Remarques

  • Un fichier pèse 20 Mo au plus, et un déploiement compte 15 000 fichiers au plus.
  • Une équipe crée au plus 10 déploiements d'un coup, puis 60 par heure. Voir Limites.
  • Pour déployer depuis GitHub Actions, voir Déployer depuis la CI.