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 :
{
"$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
mainse déploie. Dans les troisvercel.json,git.deploymentEnableddésactive toutes les branches puis réactivemain. Il n’y a donc pas de preview. Une autre branche ne passe jamais par un build, et un push surmainpart directement en prod. - Le build n’a lieu que si le commit touche l’application.
ignoreCommandcompare 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 unignoreCommandde plus de 256 caractères. Et le build de la doc lit aussi les captures du manuel de l’ERP etapps/site/ARCHITECTURE.md, donc il doit les surveiller. - Le build régénère le client Prisma (
builddeapps/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.tspour l’ERP).check:vercel-env(apps/erp/scripts/check-vercel-env.mts, et son équivalent dansapps/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, etFAMILY_BUDGETSdeapps/erp/scripts/check-initial-js.mjs).pnpm sizele 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:applyle pose en brouillon, et--publishle publie (Sécurité). - La veille tourne chaque matin. La tâche planifiée du projet de l’ERP (
cronsci-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 »).