Formations — 1 037 leçons en français

Accueil › Node.js › Migrer sans interruption de service

Migrer sans interruption de service

ORM et migrationsintermediaire

Un déploiement n'est pas instantané. Pendant quelques secondes à quelques minutes, l'ancienne et la nouvelle version du code tournent ensemble sur la même base. Toute migration doit survivre à cette cohabitation.

Ce qu'on ne fait pas

ALTER TABLE clients RENAME COLUMN email TO courriel;

La base accepte, instantanément. Et chaque requête servie par une instance pas encore remplacée échoue sur une colonne qui n'existe plus. Même chose pour une suppression, un changement de type, un NOT NULL posé d'un coup.

Les cinq étapes

1. ajouter      ALTER TABLE clients ADD COLUMN courriel text;
2. déployer     le code écrit dans email ET courriel, lit email
3. remplir      UPDATE … SET courriel = email WHERE courriel IS NULL  (par lots)
4. déployer     le code lit courriel, écrit toujours dans les deux
5. déployer     le code n'utilise plus email
6. retirer      ALTER TABLE clients DROP COLUMN email;

Chaque étape est déployable seule, et chaque état intermédiaire fonctionne avec les deux versions du code. C'est le seul test à faire passer.

Le contrôle, étape par étape

État obtenu Ancien code Nouveau code
colonne ajoutée, nullable fonctionne fonctionne
double écriture déployée fonctionne fonctionne
lecture basculée fonctionne fonctionne
email supprimée avant l'étape 5 casse fonctionne

Une seule case qui casse, et le déploiement devient une interruption de service.

Réussir n'est pas suffire

ALTER TABLE commandes ADD COLUMN total_ttc numeric NOT NULL DEFAULT 0;
CREATE INDEX idx_commandes_client ON commandes (client_id);

Ces deux ordres « réussissent ». Sur une grande table, le second prend un verrou qui bloque les écritures le temps de la construction — et le service est coupé pendant une migration qui n'a signalé aucune erreur.

Les termes à connaître

Déploiement en deux temps

On étend le schéma, on fait coexister les deux formes, puis on retire l'ancienne. Chaque étape est déployable seule, et chaque état intermédiaire fonctionne avec les deux versions du code.

Compatibilité ascendante

L'ancienne version du code continue de fonctionner sur le nouveau schéma. Sans elle, il n'y a pas de déploiement progressif possible, ni de retour arrière.

Double écriture

La période pendant laquelle le code écrit dans l'ancienne et la nouvelle colonne. C'est ce qui permet de basculer la lecture sans perdre d'écriture.

Remplissage

Le traitement par lots qui donne une valeur aux lignes existantes. Il tourne entre les deux déploiements, et il doit pouvoir être relancé.

Verrou exclusif

Un verrou qui bloque les lectures et les écritures sur la table. Pris une minute sur une grande table, il coupe la production même si la migration « réussit ».

Délai de verrou

La durée maximale pendant laquelle une migration accepte d'attendre un verrou. Sans limite, elle attend derrière une transaction longue et met toutes les requêtes suivantes en file.

Index concurrent

La création d'un index sans bloquer les écritures. Plus lente, hors transaction, et la seule acceptable sur une table active.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.