Accueil › Docker & conteneurs › Migrations de schéma, et ce qu'on ne conteneurise pas
Migrations de schéma, et ce qu'on ne conteneurise pas
État et stockageavance
Une migration de schéma modifie des données partagées par toutes les répliques. Deux décisions suffisent à la rendre sûre : où elle s'exécute, et dans quel ordre par rapport au déploiement du code.
Une étape dédiée, pas un démarrage
La migration est un conteneur à vie courte, lancé une fois, qui sort avec un code de retour. Le déploiement s'arrête s'il est non nul.
services:
migration:
image: api:2.4.0
command: ["npm", "run", "migrate"]
depends_on:
db:
condition: service_healthy
restart: "no"
api:
image: api:2.4.0
depends_on:
migration:
condition: service_completed_successfully
La jouer au démarrage de chaque réplique paraît pratique et pose deux problèmes : plusieurs processus tentent la même opération au même instant, et un échec déclenche une boucle de redémarrage au lieu d'un déploiement arrêté.
Un verrou, même avec une étape dédiée
Le verrou se prend dans la base. Il garantit qu'une seule migration progresse à la fois, y compris quand deux déploiements se chevauchent. Il reste nécessaire avec une étape dédiée : rien n'empêche deux chaînes de se lancer en même temps.
Compatibilité ascendante
Pendant un déploiement progressif, l'ancienne et la nouvelle version du code parlent à une seule base. Le schéma migré doit donc rester utilisable par l'ancienne version. Ajouter une colonne nullable est compatible. En supprimer une, la renommer ou la rendre obligatoire ne l'est pas. Ces changements-là se découpent en plusieurs déploiements.
Les termes à connaître
- Étape de migration dédiée
Un conteneur à vie courte, lancé une fois avant le déploiement, dont le seul rôle est d'appliquer les migrations et de sortir avec un code de retour.
- Verrou de migration
Un verrou pris dans la base elle-même pour garantir qu'une seule migration s'exécute à la fois, même si plusieurs processus démarrent en même temps.
- Table des migrations appliquées
La table où le moteur de migration note ce qu'il a déjà joué. C'est elle qui rend l'opération rejouable sans effet.
- Compatibilité ascendante du schéma
La propriété d'un schéma migré qui reste utilisable par la version de code précédente. Sans elle, les deux versions ne peuvent pas tourner en même temps.
- Migration en plusieurs temps
Le découpage d'un changement destructif en étapes compatibles : ajouter, écrire des deux côtés, basculer la lecture, puis seulement supprimer.
- Service géré
Une base ou un courtier exploité par un fournisseur, avec sauvegardes, bascule et correctifs inclus. On n'en conteneurise que le client.
- Système à état réparti
Un système dont les instances se coordonnent et dont l'identité de chaque membre compte — par opposition à des répliques interchangeables.
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.