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.
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.