Aller au contenu principal

Publié le

Rollback Vercel et Supabase : gérer un incident en prod

Dimitri Dumont
Dimitri Dumont

Développeur React & Next.js freelance

Un fondateur peut arrêter seul un incident en production sur une app Next.js, Vercel et Supabase si trois gestes sont prêts à l'avance. Il revient au déploiement précédent avec Instant Rollback, coupe une fonctionnalité sans redéployer ou passe l'application en maintenance. Aucun de ces gestes ne touche à la base. La réparation attend le développeur.

Un rollback Vercel ne restaure que le code. Le schéma et les données restent dans leur état actuel. Pour que le retour arrière fonctionne, le code précédent doit savoir tourner sur le nouveau schéma, et une copie de la base doit exister d'avant chaque migration. Ce guide décrit ce que je mets en place sur les applications que je maintiens, à jour au 18 novembre 2026.

Les trois gestes sans danger pendant un incident

GesteQuandEffetLimite
Instant RollbackLe problème suit un déploiementCode précédent en quelques secondesNe restaure ni schéma ni données
Interrupteur de fonctionnalitéUne fonctionnalité pose problème (emails, paiements)Fonctionnalité coupée en moins de 10 sNe corrige pas la cause
Mode maintenanceDonnées exposées, app inutilisableLes pages répondent 503L'API Supabase reste joignable

Les autres gestes (restaurer une sauvegarde, lancer du SQL, modifier une table dans le tableau de bord) peuvent aggraver l'incident et attendent le développeur.

Revenir au code précédent avec Instant Rollback

Instant Rollback redirige les domaines de production vers un déploiement précédent, sans reconstruire l'application. Le bouton est sur la tuile Production Deployment du projet dans le tableau de bord. Il reste à choisir le déploiement et à cliquer sur Confirm Rollback. La commande équivalente est vercel rollback.

Instant Rollback ne permet de revenir qu'au déploiement précédent en Hobby, et à tout déploiement déjà passé en production en Pro.

Le fondateur doit avoir accès au projet. Un compte Hobby est personnel, et s'il appartient au développeur, le fondateur ne peut rien faire. En Pro, les rôles Owner, Member et Developer peuvent lancer un rollback.

Les variables d'environnement et les crons restent ceux du build restauré. Une clé renouvelée depuis y reste l'ancienne.

Les nouveaux push ne passent plus en production automatiquement après un rollback. Le déploiement restauré reste en place tant que personne n'en promeut un autre, avec le bouton Manage de la tuile ou vercel promote <url>. Le correctif ne part donc en production qu'une fois vérifié et promu.

Le rollback Vercel n'annule pas les migrations Supabase

Le code restauré tourne sur le schéma actuel. La commande supabase db push ne fait qu'avancer : elle applique les migrations absentes et ignore celles déjà passées. Une migration fautive se corrige par une migration de plus. La CLI propose supabase migration down, que je réserve à la base locale. Modifier un fichier déjà appliqué n'a aucun effet en production, et la base ne correspond plus au dépôt.

Des migrations compatibles avec la release précédente

Le code de la release N-1 doit fonctionner sur le schéma de la release N. Chaque changement destructif se fait donc en deux releases.

ChangementRelease NRelease N+1 (N stable)
Remplacer une colonneAjouter la nouvelle, le code écrit dans les deuxRecopier, supprimer l'ancienne
Rendre une colonne obligatoireLe code la remplit toujoursnot null
Restreindre une politique RLSLe code respecte déjà la règleNouvelle politique

Renommer une colonne en une seule migration casse N-1 immédiatement. Le rollback remet alors un code qui lit une colonne disparue.

Une copie de la base avant chaque migration

Le job de migration du pipeline de livraison prend une copie chiffrée avec age juste avant db push. Les étapes de checkout, d'installation des outils et de supabase link sont omises ici.

.github/workflows/livraison.yml
jobs:
  migrer:
    needs: [verifier, tester-rls]
    runs-on: ubuntu-latest
    concurrency:
      group: supabase-prod
      cancel-in-progress: false
    steps:
      - name: Copie de la base avant migration
        run: bash scripts/snapshot.sh avant-migration.tar.gz.age
 
      - uses: actions/upload-artifact@v7
        with:
          name: avant-migration-${{ github.sha }}
          path: avant-migration.tar.gz.age
          retention-days: 90
          if-no-files-found: error
 
      - run: supabase db push --remote --yes

Si la copie échoue, db push ne s'exécute pas. L'archive porte le SHA du commit, ce qui permet de retrouver l'état d'avant une migration donnée. L'option if-no-files-found passe à error parce que la valeur par défaut (warn) laisse passer une copie absente. Le groupe concurrency est partagé avec la sauvegarde quotidienne pour ne jamais copier une base à moitié migrée.

La CLI Supabase v3, sortie en novembre 2026, cible la base locale par défaut. En CI, --remote vise le projet hébergé et --yes confirme les modifications. Un workflow écrit pour la v2 avec --linked fonctionne encore avec un avertissement, mais ce drapeau disparaîtra en v4. La version de la CLI se fixe donc dans le workflow.

La sauvegarde quotidienne appelle le même script :

scripts/snapshot.sh
set -euo pipefail
 
sortie="$1"
dossier="$(mktemp -d)"
trap 'rm -rf "$dossier"' EXIT
 
supabase db dump -f "$dossier/schema.sql" --remote
supabase db dump -f "$dossier/donnees.sql" --data-only --use-copy --remote
 
test -s "$dossier/schema.sql" && test -s "$dossier/donnees.sql" || { echo "Copie vide, abandon"; exit 1; }
grep -qF '"auth"."users"' "$dossier/donnees.sql" || { echo "auth.users absent, abandon"; exit 1; }
 
tar czf - -C "$dossier" schema.sql donnees.sql | age -R sauvegarde.age.pub > "$sortie"

Un dump vide s'archive sans erreur. Les deux contrôles font échouer le script dans ce cas. Le chiffrement est obligatoire car le dump contient aussi le schéma auth, sessions comprises. La CI ne détient que la clé publique, donc un jeton GitHub volé ne donne accès qu'à des archives illisibles. La clé privée reste hors du dépôt et de la CI.

Le déploiement automatique de Vercel est coupé ("git": { "deploymentEnabled": false } dans vercel.json) et un job de CI déploie après les migrations, pour que le code ne parte jamais avant la copie. Le détail est dans sécuriser Next.js, Supabase et Vercel.

Sauvegardes Supabase et restauration

PlanSauvegarde quotidiennePoint-in-Time Recovery (PITR)
FreeAucuneNon
Pro7 joursOption, 7, 14 ou 28 jours
Team14 joursOption
EnterpriseJusqu'à 30 joursOption

Le PITR restaure à la seconde près et remplace les sauvegardes quotidiennes une fois activé (documentation Supabase). La sauvegarde quotidienne en CI est la seule sauvegarde disponible sur le plan Free.

Aucune de ces sauvegardes ne contient les fichiers du Storage, dont la base ne garde que les métadonnées. Photos et documents se sauvegardent à part, par exemple avec supabase storage cp --recursive --remote. La commande est encore expérimentale et demande l'option --experimental.

Une restauration suit trois règles :

  1. Elle n'est jamais automatique. Un workflow qui restaure seul écrase des données fraîches par des données périmées.
  2. Elle est précédée d'une nouvelle copie de l'état actuel.
  3. Elle perd tout ce qui a été écrit depuis la copie et ramène tout ce qui a été effacé depuis, y compris les données supprimées au titre du RGPD. Ces effacements se notent au moment où on les fait pour les rejouer ensuite.

Restaurer depuis le tableau de bord Supabase rend le projet inaccessible pendant l'opération et remplace l'état courant. Une restauration dans un nouveau projet laisse l'état courant intact, et seules les lignes perdues sont recopiées. La première copie se restaure une fois en local pour vérifier qu'elle est complète, avec la commande ci-dessous.

Restaurer une copie en local

Le guide sauvegarde et restauration de Supabase recharge un dump avec psql. Pour tester une copie, je la déchiffre puis la charge dans une instance locale vide, créée par supabase init et supabase start dans un dossier sans migrations.

Terminal
age -d -i sauvegarde.age.key avant-migration.tar.gz.age | tar xzf -
 
psql \
  --single-transaction \
  --variable ON_ERROR_STOP=1 \
  --file schema.sql \
  --command 'SET session_replication_role = replica' \
  --file donnees.sql \
  --dbname postgresql://postgres:postgres@127.0.0.1:54322/postgres

session_replication_role = replica désactive les triggers pendant le chargement des données. Si schema.sql contient des lignes ALTER ... OWNER TO "supabase_admin" qui échouent, le guide Supabase conseille de les commenter. La même commande, avec la chaîne de connexion d'un nouveau projet hébergé, restaure la copie à côté de la production.

Couper sans redéployer avec Global Config

Une variable d'environnement demande un redéploiement pour changer. Global Config (ex-Edge Config) se lit à l'exécution et existe sur tous les plans. Une modification dans le tableau de bord se propage en 10 secondes au plus. Chaque fonctionnalité sensible a sa clé, et une clé maintenance coupe toute l'application.

src/lib/interrupteurs.ts
import { get } from "@vercel/global-config"
 
export const estCoupe = async (cle: "maintenance" | "envoi-bons") => {
	try {
		return (await get(cle)) === true
	} catch {
		return false
	}
}

Le mode maintenance se lit dans le proxy, avant le rafraîchissement de session Supabase :

src/proxy.ts
import { type NextRequest, NextResponse } from "next/server"
import { estCoupe } from "@/lib/interrupteurs"
import { rafraichirSession } from "@/lib/supabase/proxy"
 
export const proxy = async (requete: NextRequest) => {
	if (await estCoupe("maintenance")) {
		return new NextResponse("Maintenance en cours.", { status: 503, headers: { "Retry-After": "3600" } })
	}
 
	return rafraichirSession(requete)
}

L'interrupteur d'une fonctionnalité se lit dans la Server Action, juste après la vérification de session. Un bouton masqué n'empêche pas un POST direct sur l'action.

src/actions/bons.ts
if (await estCoupe("envoi-bons")) return { ok: false, erreur: "Envoi suspendu" } as const

Ce système a trois limites. Le plan Hobby inclut 100 000 lectures et le proxy en consomme une par requête, donc son matcher exclut les fichiers statiques. Le mode maintenance ne coupe que Next.js : le navigateur peut toujours appeler l'API Supabase avec la clé publishable, et seule la RLS protège alors les données. Enfin, si Global Config ne répond pas, estCoupe laisse l'application tourner. Pour une fonctionnalité dont l'erreur coûte plus cher que l'indisponibilité, comme un paiement, le catch renvoie true.

La procédure d'incident sur une page

Elle vit dans le dépôt et à un endroit que le fondateur ouvre sans le développeur. Les deux la répètent une fois un jour calme, avec un rollback sur un déploiement sain et une clé passée à true puis remise à false.

INCIDENT.md
# Incident en production
 
Aucun développeur avant le prochain jour ouvré. Le but est d'arrêter les dégâts sans en ajouter.
 
## 1. Repérer (5 minutes)
- Vercel > projet > Logs, niveau Error, environnement Production.
  Faire des captures tout de suite. Vercel garde 1 heure de logs en Hobby et 1 jour en Pro.
- Supabase > Logs : Auth, PostgREST, Storage. La rétention est courte, faire des captures aussi.
- Noter l'heure du début et celle du dernier déploiement (Vercel > Deployments).
 
## 2. Arrêter
- Si le problème a commencé après le dernier déploiement :
  tuile Production Deployment > Instant Rollback > déploiement précédent > Confirm Rollback.
- Si une seule fonctionnalité pose problème (emails, paiements, envois) :
  Vercel > Storage > Global Config, passer sa clé à true. L'effet arrive en moins de 10 secondes.
- Si des données sont exposées ou l'application inutilisable, passer `maintenance` à true.
- Vérifier que le symptôme a cessé.
 
## 3. Ne pas toucher
- Aucune restauration, aucun SQL, aucune modification de table dans le tableau de bord Supabase.
- Ne pas relancer la livraison et ne pas promouvoir un autre déploiement.
- Ne pas remettre `maintenance` à false sans le développeur.
 
## 4. Prévenir le développeur
Donner l'heure du début, les captures, ce qui a été coupé ou restauré.
Signaler toute fuite possible de données personnelles. La CNIL se notifie sous 72 heures.

Le délai de 72 heures commence dès la découverte de la violation (CNIL), même si le développeur n'est pas joignable.

FAQ

Un rollback Vercel annule-t-il une migration Supabase ?

Non. Instant Rollback redirige les domaines vers un ancien déploiement, et ce code tourne sur le schéma actuel. Une migration se corrige par une nouvelle migration. Des données écrasées se récupèrent depuis la copie prise avant la migration.

Faut-il payer le PITR de Supabase ?

Pas au démarrage. Les sauvegardes quotidiennes du plan Pro et la copie avant chaque migration couvrent la plupart des cas. Le PITR se justifie quand une journée d'écritures perdues coûte plus cher que l'option, par exemple sur des paiements ou des données que les clients saisissent en continu.

Comment annuler un déploiement sur Vercel ?

Avec Instant Rollback, depuis la tuile Production Deployment du projet ou avec vercel rollback. Les domaines passent sur le déploiement choisi en quelques secondes, sans reconstruction. Les nouveaux push ne partent ensuite plus en production tant qu'un déploiement n'est pas promu avec vercel promote.

Comment sauvegarder une base Supabase sur le plan gratuit ?

Avec supabase db dump dans une tâche planifiée. Le plan Free n'a aucune sauvegarde automatique. Un workflow GitHub Actions quotidien exporte le schéma et les données, chiffre l'archive et la garde comme artefact. Les fichiers du Storage se copient à part.

Que restaurer en premier après une migration ratée ?

Rien dans la précipitation. Le fondateur arrête les dégâts avec un rollback ou un interrupteur. Le développeur compare ensuite la copie d'avant migration avec l'état actuel, puis recopie les lignes perdues depuis un projet restauré à part. Une restauration complète de la production n'intervient que si les données actuelles sont inutilisables.

Dimitri Dumont

Dimitri Dumont

Développeur React & Next.js freelance depuis 8 ans, 35 entreprises accompagnées depuis 2018. J'écris ici ce que je constate en mission : un produit ralentit presque toujours pour les mêmes raisons, une architecture posée dans l'urgence, pas de tests, une mise en production qui fait peur. Mon travail consiste à construire des produits qui n'en arrivent pas là, et à remettre sur pied ceux qui y sont déjà. Mon parcours

La suite

Un produit existant à reprendre

Du code écrit dans l'urgence ou généré se reprend, il se réécrit rarement. On fige l'environnement, on pose les garde-fous, puis on traite par étapes sans arrêter ce qui tourne.

Articles similaires