deploiement.md 12 KB

Déploiement — AImpact Hub

Hébergement : Vercel (plan Hobby, région US East iad1). Base de données : Neon (PostgreSQL, région EU eu-central-1). Déploiement : CLI Vercel locale (pas de lien Git automatique — voir note ci-dessous).

Client Prisma : généré dans aimpact-hub/generated/prisma (pas dans node_modules). Le script postinstall exécute prisma generate à chaque pnpm install.


Résumé rapide « tout refaire »

Étape Commande
Libérer les verrous Windows Fermer pnpm dev / Studio, puis taskkill si besoin (voir section dédiée)
Nettoyer (local) Supprimer .next, node_modules, generated
Install + Prisma pnpm install (ou --ignore-scripts si EPERM) puis pnpm exec prisma generate
DB prod pnpm db:migrate avec DATABASE_URL Neon prod
Test build local pnpm build
Déployer npx vercel --prod ou Redeploy + Clear cache (dashboard Vercel)

Libérer les fichiers verrouillés (kill processus Windows)

Sur Windows, Prisma et pnpm échouent souvent si un ancien processus garde ouvert generated\prisma\query_engine-windows.dll.node ou des fichiers dans .next/.

Quand tuer les tâches ?

Faire un « kill » avant pnpm install, prisma generate ou la suppression de dossiers si tu vois :

  • EPERM: operation not permitted sur query_engine-windows.dll.node
  • EBUSY: resource busy or locked
  • Remove-Item / rmdir qui refuse de supprimer generated, .next ou node_modules
  • pnpm install ou prisma generate qui restent bloqués sans fin
  • Le port 3000 déjà utilisé au lancement de pnpm dev

Ordre recommandé (du plus doux au plus radical)

  1. Arrêter proprement dans chaque terminal Cursor / PowerShell :
    • Ctrl+C sur pnpm dev, pnpm db:studio, pnpm test:watch, vitest
  2. Fermer les onglets qui tournent encore (terminal intégré avec un serveur actif).
  3. Fermer Prisma Studio si ouvert (pnpm db:studio).
  4. Si ça bloque encore → kill Node (voir ci-dessous).
  5. En dernier recours → redémarrer Cursor, ou la session Windows.

CMD — kill tous les processus Node

⚠️ Tue tous les node.exe de la machine (y compris d’autres projets ou outils basés sur Node). À utiliser quand rien d’autre ne suffit.

taskkill /f /im node.exe

Attendre 2–3 secondes, puis supprimer et réinstaller :

cd /d "C:\Users\USER\Documents\Intersel - Livinweb\dev\AImpact-Ai_Hub\aimpact-hub"
rmdir /s /q generated
rmdir /s /q .next
pnpm install --ignore-scripts
pnpm exec prisma generate

PowerShell — équivalent

Get-Process node -ErrorAction SilentlyContinue | Stop-Process -Force
Start-Sleep -Seconds 2
cd "C:\Users\USER\Documents\Intersel - Livinweb\dev\AImpact-Ai_Hub\aimpact-hub"
Remove-Item -Recurse -Force generated, .next -ErrorAction SilentlyContinue
pnpm install --ignore-scripts
pnpm exec prisma generate

Libérer le port 3000 (Next.js déjà lancé)

netstat -ano | findstr :3000

Noter le PID (dernière colonne), puis :

taskkill /f /pid NUMERO_DU_PID

PowerShell :

Get-NetTCPConnection -LocalPort 3000 -ErrorAction SilentlyContinue |
  ForEach-Object { Stop-Process -Id $_.OwningProcess -Force }

Processus qui verrouillent le plus souvent

Processus / commande Fichiers concernés
pnpm dev (Turbopack) .next/, parfois modules
pnpm db:studio moteur Prisma / generated/
pnpm test:watch / Vitest cache, parfois node_modules
Ancien terminal oublié tout ce qui tourne encore en arrière-plan
Éditeur (Cursor) + TS Server rarement generated/ ; en cas de doute, fermer le dossier aimpact-hub ou redémarrer l’éditeur

Checklist rapide avant un reset complet

[ ] Ctrl+C dans tous les terminaux du projet
[ ] Plus de Prisma Studio
[ ] taskkill /f /im node.exe  (si EPERM / EBUSY)
[ ] Supprimer generated, .next, (optionnel) node_modules
[ ] pnpm install --ignore-scripts
[ ] pnpm exec prisma generate
[ ] pnpm build

Rappel : ces blocages sont locaux Windows. Un npx vercel --prod peut réussir même si le poste de dev est bloqué, car le build tourne sur Linux chez Vercel.


Procédure complète en local (reset + build)

Répertoire de travail : aimpact-hub/.

PowerShell

cd "C:\Users\USER\Documents\Intersel - Livinweb\dev\AImpact-Ai_Hub\aimpact-hub"

# Si EPERM / fichiers verrouillés : arrêter dev/studio puis kill Node
Get-Process node -ErrorAction SilentlyContinue | Stop-Process -Force
Start-Sleep -Seconds 2

# Nettoyer
Remove-Item -Recurse -Force .next, node_modules, generated -ErrorAction SilentlyContinue

# Réinstaller (postinstall = prisma generate)
pnpm install

# Générer le client Prisma à la main (au cas où)
pnpm exec prisma generate

# Appliquer les migrations (nécessite DATABASE_URL dans .env ou ci-dessous)
pnpm exec prisma migrate deploy

# Optionnel : données de démo
pnpm exec prisma db seed

# Vérifier que le build Next.js passe
pnpm build

# Relancer le dev
pnpm dev

CMD (si EPERM sur query_engine-windows.dll.node)

cd /d "C:\Users\USER\Documents\Intersel - Livinweb\dev\AImpact-Ai_Hub\aimpact-hub"
taskkill /f /im node.exe
rmdir /s /q .next
rmdir /s /q node_modules
rmdir /s /q generated
pnpm install --ignore-scripts
pnpm exec prisma generate
pnpm build

--ignore-scripts évite l'erreur Windows sur le binaire Prisma verrouillé ; Vercel regénère Prisma sur Linux au build.


Commandes de redéploiement (ordre à respecter)

cd /d "C:\Users\USER\Documents\Intersel - Livinweb\dev\AImpact-Ai_Hub\aimpact-hub"

pnpm install --ignore-scripts
pnpm db:migrate
npx vercel --prod
  • --ignore-scripts : contourne l'erreur EPERM Windows sur generated\prisma\query_engine-windows.dll.node (Vercel regénère Prisma lui-même sur Linux).
  • pnpm db:migrate : seulement si de nouvelles migrations Prisma ont été ajoutées depuis le dernier déploiement. Nécessite DATABASE_URL pointant vers Neon prod.
  • npx vercel --prod : envoie les fichiers locaux et déclenche le build sur Vercel.

Redéployer sans nouveau commit (dashboard Vercel)

  1. Deployments → dernier déploiement → Redeploy.
  2. Cocher Clear build cache si le build échoue de façon incohérente (module manquant, ancien artefact).
  3. Attendre la fin du build ; vérifier les logs (prisma generate doit apparaître pendant postinstall).

Redéployer via Git (miroir GitHub uniquement)

Si un remote GitHub est connecté à Vercel :

cd "/c/Users/USER/Documents/Intersel - Livinweb/dev/AImpact-Ai_Hub"
git add -A
git commit -m "Description"
git push origin main

Sinon, le push vers Gitea ne déclenche pas Vercel — utiliser npx vercel --prod.


Appliquer les migrations sur Neon prod

DATABASE_URL prod se trouve dans : Vercel → Project → Settings → Environment Variables.

set DATABASE_URL=postgresql://...URL_NEON_PROD...?sslmode=require
pnpm db:migrate

Vérifier que tout est appliqué :

pnpm exec prisma migrate status

Toutes les migrations doivent être en Applied.


Erreur fréquente : ERR_PNPM_OUTDATED_LOCKFILE

Cause : pnpm-lock.yaml local n'est pas synchronisé avec package.json (ex. après un pnpm add ou pnpm remove).

Fix :

pnpm install
npx vercel --prod

Si pnpm install échoue avec EPERM :

taskkill /f /im node.exe
rmdir /s /q generated\prisma
pnpm install --ignore-scripts
npx vercel --prod

Erreur fréquente : EPERM sur query_engine-windows.dll.node

Cause : Un processus Windows verrouille le fichier (serveur dev, Prisma Studio, terminal oublié).

Fix : suivre la section Libérer les fichiers verrouillés (kill processus Windows) ci-dessus.

Résumé minimal :

taskkill /f /im node.exe
rmdir /s /q generated\prisma
pnpm install --ignore-scripts
pnpm exec prisma generate

Note : Cette erreur est locale à Windows. Elle n'empêche pas Vercel de builder (Linux).


Erreur fréquente : Can't resolve '~/generated/prisma'

Cause : L'alias TypeScript ~/* pointe vers ./src/*. L'import ~/generated/prisma est donc résolu vers src/generated/prisma, qui n'existe pas. Le client Prisma est généré dans generated/prisma à la racine de aimpact-hub/.

prisma generate seul ne corrige pas cette erreur.

Fix (choisir une option) :

  1. Alias dédié dans aimpact-hub/tsconfig.json :

    "paths": {
    "~/*": ["./src/*"],
    "~/generated/*": ["./generated/*"]
    }
    
  2. Imports relatifs (comme dans src/server/db.ts) :

    import { FeedbackType } from "../../../generated/prisma";
    

Fichiers historiquement concernés : src/server/api/routers/feedback.ts, src/components/feedback/FeedbackForm.tsx, src/components/feedback/FeedbackList.tsx.

Après correction : pnpm exec prisma generate puis pnpm build.


Vérifications Vercel avant / après déploiement

  • Settings → Environment Variables : DATABASE_URL (Production + Preview), AUTH_SECRET, NEXT_PUBLIC_APP_URL, etc. (voir tableau ci-dessous).
  • Root Directory : aimpact-hub si le dépôt monorepo est à la racine AImpact-Ai_Hub.
  • Build logs : prisma generate pendant postinstall, puis next build sans erreur de module.
  • Analytics (optionnel POC) : package @vercel/analytics + <Analytics /> dans src/app/layout.tsx ; les données n'apparaissent qu'en production déployée (pas en pnpm dev local).

Sauvegarder le code (Git)

Le repo principal est sur Gitea :

https://git.intersel.fr/augustin.podvin/AImpact-Hub.git
cd "/c/Users/USER/Documents/Intersel - Livinweb/dev/AImpact-Ai_Hub"
git add -A
git commit -m "Description"
git push origin master

Le push Git ne déclenche pas de déploiement Vercel automatique (pas de lien GitHub/GitLab configuré). Le déploiement se fait séparément avec npx vercel --prod.


Limites Vercel (plan Hobby gratuit)

Ressource Limite
Builds par jour 100
Durée max d'un build 45 min
Bandwidth 100 GB/mois
Edge function invocations 500 000/mois

Largement suffisant en phase de développement et de démarrage.


Variables d'environnement requises en prod (Vercel)

Variable Rôle
DATABASE_URL URL Neon prod
AUTH_SECRET Clé secrète NextAuth (générer avec npx auth secret)
NEXT_PUBLIC_APP_URL URL publique de l'app (ex. https://aimpact-hub.vercel.app)
RESEND_API_KEY Clé Resend pour les emails
EMAIL_FROM Adresse expéditeur emails
BLOB_READ_WRITE_TOKEN Token Vercel Blob (pièces jointes)
CRON_SECRET Secret cron relance J+21 (générer avec openssl rand -hex 32)
OPENAI_API_KEY Optionnel — exemples contextuels LLM
RESEND_WEBHOOK_SECRET Optionnel — webhook email entrant
INBOUND_EMAIL_DOMAIN Optionnel — domaine Resend inbound

Note : pourquoi pas GitHub → Vercel ?

Le repo est hébergé sur un Gitea auto-hébergé (git.intersel.fr) que Vercel ne supporte pas nativement. Options possibles si besoin de déploiement automatique :

  • Ajouter un miroir GitHub (repo privé) + connecter Vercel à GitHub → git push déclenche le build automatiquement.
  • Ajouter GitHub comme second remote pour pousser sur les deux en une commande :

    git remote set-url --add --push origin https://github.com/TON_USER/aimpact-hub.git
    git remote set-url --add --push origin https://git.intersel.fr/augustin.podvin/AImpact-Hub.git
    

Pour l'instant le workflow CLI (npx vercel --prod) est suffisant.