Comment séparer les migrations de base de données du démarrage de l’application lors des déploiements de conteneurs

Eva Wong est la rédactrice technique et bricoleuse résidente chez ZimaSpace. Geek depuis toujours, passionnée par les laboratoires informatiques personnels et les logiciels open source, elle se spécialise dans la vulgarisation de concepts techniques complexes au moyen de guides pratiques et concrets. Eva pense que l’hébergement personnel doit être amusant, et non intimidant. À travers ses tutoriels, elle aide la communauté à démystifier les configurations matérielles, de la construction de leur premier NAS à la maîtrise des conteneurs Docker.

Il est plus facile d’éviter les migrations de base de données en double lorsque les modifications du schéma sont exécutées comme une seule étape explicite du déploiement, plutôt qu’au démarrage de chaque conteneur d’application.

La méthode préventive consiste à confier les migrations à un seul responsable, avec un seul jeu d’identifiants et un seul signal d’achèvement, avant que les nouveaux réplicas commencent à traiter le trafic. Permettez aux conteneurs web et worker de redémarrer sans disposer des privilèges nécessaires pour modifier le schéma, faites attendre le déploiement jusqu’à la réussite d’une tâche de migration et concevez les modifications du schéma de façon à permettre la coexistence temporaire des anciennes et des nouvelles versions de l’application. La condition de concurrence disparaît ainsi, au lieu d’espérer simplement que chaque réplica détecte le même historique de migration en premier.

Supprimer les commandes de migration du démarrage normal de l’application

Vérifiez le point d’entrée de l’image, la commande Compose, la commande du worker, l’enveloppe de contrôle d’état et le script de déploiement pour repérer les appels automatiques aux migrations. L’application doit pouvoir redémarrer sans modifier le schéma, sauf si ce redémarrage correspond à l’étape de migration délibérément choisie.

Un article d’Octopus sur le déploiement affirme que les migrations ont besoin d’un cycle de vie distinct, plutôt que d’être liées au démarrage de chaque processus de microservice.

Gardez le binaire de migration disponible là où il est nécessaire, mais ne le lancez pas à la fois depuis le point d’entrée web et depuis une seconde tâche. Un responsable explicite est plus facile à auditer que plusieurs chemins de démarrage qui reposent tous sur le verrouillage du framework.

Exécuter une seule tâche de migration avant le déploiement

Créez une tâche ponctuelle qui utilise les mêmes fichiers de migration que la version et ne se termine avec succès qu’une fois que la base de données cible a atteint l’état de schéma attendu. Faites dépendre le déploiement de l’application de ce résultat.

Un guide de déploiement actuel montre comment une seule tâche s’exécute avant le déploiement, au lieu de laisser chaque réplica se lancer en parallèle au démarrage.

Ne mettez pas la tâche de migration à l’échelle comme le service applicatif. La tâche doit avoir un seul responsable d’exécution par base de données cible, un délai d’expiration limité, des journaux et un état d’échec clair qui bloque la nouvelle version de l’application.

Conditionner le démarrage de l’application à la réussite de la migration

Faites attendre les nouveaux conteneurs web et worker jusqu’à ce que l’étape de migration signale sa réussite, mais ne faites pas relancer la migration par chaque conteneur en attente. La dépendance porte sur le résultat, pas sur la réexécution de la modification du schéma.

Le modèle de déploiement d’Andrew Lock prévoit que les pods de l’application attendent la migration, tandis que la logique de migration reste centralisée.

Pour une petite infrastructure de serveur domestique, le même principe peut être mis en œuvre avec un service Compose dédié et un script de déploiement contrôlé. Gardez le mécanisme suffisamment simple pour qu’une migration échouée arrête visiblement le déploiement.

Utiliser des modifications de schéma rétrocompatibles pendant la période de chevauchement

Lors d’un déploiement progressif, d’anciennes et de nouvelles versions de l’application peuvent temporairement accéder à la même base de données. Évitez toute migration qui supprime ou renomme un champ avant que l’ancienne version ait cessé de l’utiliser.

Un récent guide sur les migrations sans interruption de service recommande d’étendre avant de contracter, afin que les modifications additives du schéma soient mises en place avant le nettoyage destructif.

Si nécessaire, décomposez les modifications importantes en phases d’extension, de remplissage, de bascule et de contraction. La tâche de migration ne doit pas créer un schéma que seul le nouveau conteneur comprend alors que d’anciens réplicas traitent encore des requêtes.

Ne pas exposer les identifiants de migration aux réplicas de l’application

Dans la mesure du possible, utilisez un compte de base de données disposant des privilèges de modification du schéma uniquement pour l’étape de migration ponctuelle. Les conteneurs de l’application en fonctionnement normal doivent conserver les autorisations de lecture et d’écriture plus restreintes nécessaires aux données de l’application.

Un article sur le déploiement avec Liquibase indique que les modifications de la base de données doivent être intégrées à l’automatisation, avec une application contrôlée et reproductible des changements.

Cette séparation réduit les risques d’exécution accidentelle de migrations, même si un processus de l’application est redémarré ou dupliqué. Stockez les identifiants à privilèges élevés dans le chemin des secrets du déploiement, et non dans l’environnement ordinaire du service à longue durée de vie.

Vérifier que le déploiement ne peut pas appliquer le lot deux fois

Testez le déploiement sur une base de données jetable ou un instantané restauré en démarrant plusieurs réplicas de l’application, en les redémarrant et en relançant la commande de déploiement. L’étape de migration doit signaler l’état actuel du schéma sans le modifier une seconde fois.

JetBrains résume la règle opérationnelle ainsi : exécuter les migrations comme une étape du déploiement avant le démarrage normal de l’application.

La politique de prévention est complète lorsque les redémarrages de l’application ne peuvent pas modifier le schéma, qu’une migration échouée bloque le déploiement et que les exécutions répétées du déploiement ne modifient pas la base de données. L’article ZimaSpace associé sur le diagnostic des migrations en double constitue la procédure de récupération si une exécution en double a déjà eu lieu.

Assistance et conseils

À lire aussi

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.