Aller au contenu
Meubles Morinière

Le codeQualité et livraison4 min de lecture

Déploiement sur Vercel

Trois projets Vercel qui ne déploient que main, ce qui lance ou saute un build, ce qui est vérifié avant, ce qui surveille la prod après, et comment revenir en arrière.

Chaque application a son projet Vercel, avec son dossier racine (apps/erp, apps/site, apps/docs) et ses variables. Les trois servent leurs fonctions depuis la région Paris (regions) et ne déploient que main :

apps/erp/vercel.json
{
	"$schema": "https://openapi.vercel.sh/vercel.json",
	"framework": "nextjs",
	"buildCommand": "pnpm --filter @meublesmoriniere/erp build",
	"ignoreCommand": "p=${VERCEL_GIT_PREVIOUS_SHA:-HEAD^}; git cat-file -e \"$p^{commit}\" 2>/dev/null || exit 1; git diff --quiet \"$p\" HEAD -- . ../../packages ../../pnpm-lock.yaml ../../package.json ../../pnpm-workspace.yaml",
	"regions": ["cdg1"],
	"git": { "deploymentEnabled": { "**": false, "main": true } },
	"crons": [{ "path": "/api/veille", "schedule": "0 6 * * *" }]
}

Ce qui déclenche un build

  • Seule la branche main se déploie. Dans les trois vercel.json, git.deploymentEnabled désactive toutes les branches puis réactive main. Il n’y a donc pas de preview. Une autre branche ne passe jamais par un build, et un push sur main part directement en prod.
  • Le build n’a lieu que si le commit touche l’application. ignoreCommand compare le commit au déploiement précédent (VERCEL_GIT_PREVIOUS_SHA, ou à défaut le commit parent). Il regarde le dossier de l’application, packages/, le fichier de verrouillage et les manifestes de la racine. Si rien n’a changé, le build est sauté. Si on ne retrouve pas le commit précédent, le build est lancé, parce qu’on ne saute pas un build qu’on ne sait pas juger.
  • La doc a son propre script (apps/docs/scripts/ignore-build.sh). Vercel refuse un ignoreCommand de plus de 256 caractères. Et le build de la doc lit aussi les captures du manuel de l’ERP et apps/site/ARCHITECTURE.md, donc il doit les surveiller.
  • Le build régénère le client Prisma (build de apps/erp/package.json). Le code déployé est donc compilé avec le schéma du commit.

Avant le build de Vercel

Un push, c’est un déploiement. Du coup, tout ce qu’il faut vérifier avant le build se vérifie au push (La porte du push) :

  • La migration est déjà appliquée sur la base de prod, avec ses invariants (Migrations Prisma).
  • Les variables sont toutes là. L’ERP et le site valident leur environnement au démarrage avec un schéma (apps/erp/shared/schemas/env.schema.ts pour l’ERP). check:vercel-env (apps/erp/scripts/check-vercel-env.mts, et son équivalent dans apps/site/scripts/) déduit de ce même schéma les clés obligatoires en prod, donc il n’y a pas de liste à tenir à la main. Il les compare à vercel env ls. Une clé absente de Production bloque le push. Une clé absente de Preview donne seulement un avertissement tant qu’aucune preview n’est déployée, ou bloque avec --strict. Les anciennes clés retirées sont refusées (RETIRED_CREDENTIALS). Et si le CLI répond mal, la vérification échoue. Elle ne conclut pas que tout va bien.
  • Le JavaScript reste dans son budget. Le push fait le build du site et passe apps/site/scripts/check-bundle-size.mjs, qui plafonne le total des chunks (LIMIT_BYTES) et ce que charge l’accueil (HOME_LIMIT_BYTES). L’ERP a son budget aussi (apps/erp/.size-limit.js, et FAMILY_BUDGETS de apps/erp/scripts/check-initial-js.mjs). pnpm size le vérifie après un build, et ça se lance à la main.

Une fois en ligne

  • Le pare-feu est décrit dans le dépôt (apps/erp/scripts/lib/firewall-rules.ts, et le script du site). pnpm firewall:apply le pose en brouillon, et --publish le publie (Sécurité).
  • La veille tourne chaque matin. La tâche planifiée du projet de l’ERP (crons ci-dessus) appelle /api/veille, protégée par un jeton (CRON_SECRET). Elle repère les anomalies d’exploitation et envoie un résumé quand il y en a. Un matin sans anomalie, elle n’envoie rien, sauf le rapport « tout est calme » du lundi. Elle répond en erreur si une lecture n’a rien pu voir ou si le résumé n’est pas parti (modules/monitoring/services/monitoring.service.ts). À chaque passage réussi, elle prévient un témoin externe (VEILLE_HEARTBEAT_URL). Si le témoin ne reçoit plus rien, c’est que la veille est tombée ou que l’application ne répond plus. Le détail est dans ERP.

Revenir en arrière

Le dépôt n’a pas d’outil pour revenir à une ancienne version du code. C’est la plateforme qui garde les déploiements précédents. Ce qui rend ce retour sûr, c’est l’ordre des migrations. Une migration qui supprime ou renomme quelque chose se fait en deux temps (Migrations Prisma). Donc le build précédent sait encore lire la base tant que la deuxième étape n’est pas faite. Pour remettre la base dans un état antérieur, voyez Sauvegardes et reprise.

Ce que ce modèle coûte

  • Le premier build sur Vercel, c’est celui de la prod. Le push fait le build du site en local quand son bundle change, mais pas celui de l’ERP. Donc si un build de l’ERP ne marche que sur le poste, on ne le découvre que sur Vercel.
  • Un commit qui touche packages/ relance le build des trois projets, puisque chacun surveille ce dossier.
  • Deux builds lancés en même temps sur le même poste écrivent le client Prisma dans le même dossier packages/db/generated. Il vaut mieux les lancer l’un après l’autre (README, « Déploiement »).

Sur cette page