Pourquoi une application auto-hébergée exécute-t-elle deux fois la même migration de base de données après son redéploiement ?

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.

Une migration de base de données peut s’exécuter deux fois lorsque plusieurs chemins de démarrage, conteneurs ou ordonnanceurs se considèrent responsables de la même étape de mise à niveau.

Les applications auto-hébergées lancent souvent les migrations depuis un point d’entrée, un processus web, un worker, un conteneur sidecar, une unité systemd ou un hook de déploiement. Après un redéploiement, un ancien conteneur peut chevaucher un nouveau, une politique de redémarrage peut relancer un migrateur en échec, ou deux réplicas peuvent accéder à la base de données avant que l’un d’eux n’enregistre l’achèvement. Le diagnostic doit identifier tous les exécutants potentiels et vérifier si le framework de migration utilise un verrou persistant ou un enregistrement de l’historique du schéma avant toute réparation des données.

Identifier tous les processus susceptibles de lancer la migration

Recherchez la commande de migration dans le point d’entrée de l’image, la commande Compose, la commande du worker, l’unité systemd, la tâche cron, le script de déploiement et les journaux de démarrage de l’application. Notez les identifiants des processus et les noms des conteneurs aux deux heures d’exécution.

Docker Compose peut démarrer les services selon les dépendances déclarées, mais l’ordre de démarrage ne garantit pas, à lui seul, qu’un seul composant soit responsable de la migration au niveau de l’application. Les consignes officielles sur l’ordre de démarrage montrent pourquoi la disponibilité de la base de données et la responsabilité unique de la migration sont deux conditions distinctes.

Si la même commande apparaît à la fois dans le point d’entrée web et dans un service de migration dédié, supprimez l’un des deux responsables. Si une seule commande existe, poursuivez en vérifiant les réplicas, les boucles de redémarrage et les enregistrements d’état de la migration.

Vérifier le chevauchement des anciens et des nouveaux conteneurs

Lors du déploiement, répertoriez les conteneurs en cours d’exécution, en redémarrage, arrêtés et orphelins. Comparez les noms des projets et des services, les identifiants des conteneurs et leurs horodatages de création.

Systemd indique qu’une politique de redémarrage des services peut relancer une commande en échec selon les paramètres de l’unité. Son modèle de redémarrage des services aide à comprendre pourquoi un lanceur sur l’hôte peut relancer la migration après que la tentative dans le conteneur s’est terminée avec un code différent de zéro.

Ne supprimez les processus d’exécution dont il est prouvé qu’ils sont orphelins qu’après avoir conservé leurs journaux. Un deuxième horodatage de migration survenant peu après le premier correspond souvent à une nouvelle tentative plutôt qu’à une tâche planifiée distincte.

Utiliser un verrou de base de données avant d’appliquer les modifications du schéma

Déterminez si l’application acquiert un verrou au niveau de la base de données avant de lire l’état des migrations et d’appliquer les modifications. Testez deux tentatives de démarrage simultanées dans un environnement jetable.

PostgreSQL fournit des verrous consultatifs pour la coordination définie par l’application, permettant à un processus d’exécution de migration d’en exclure un autre, même si les deux démarrent presque au même moment.

Un verrou doit couvrir toute la fenêtre de décision et d’exécution. Vérifier la version actuelle du schéma avant d’acquérir le verrou permet encore à deux processus d’exécution de choisir la même migration en attente.

Vérifier la sémantique des verrous sur MySQL ou MariaDB

Pour les applications compatibles avec MySQL, vérifiez si l’outil de migration utilise un verrou nommé, une transaction ou une table de verrouillage, et si la connexion reste active pendant toute la migration.

La documentation MySQL décrit les verrous nommés liés à la connexion, qui sont libérés à la fin de la session propriétaire et doivent donc être réacquis de manière sûre après un plantage ou un redémarrage.

Une connexion interrompue peut libérer le verrou avant que le framework de migration n’enregistre la fin de l’opération. Comparez les journaux de la base de données aux horodatages de redémarrage du conteneur pour repérer cette séquence.

Examiner la table d’historique du framework de migration

Répertoriez les identifiants des migrations, leur ordre d’exécution, les indicateurs de réussite, les sommes de contrôle et les horodatages. Comparez les deux exécutions consignées aux enregistrements réellement validés dans la base de données.

Flyway utilise une table d’historique du schéma pour suivre les migrations appliquées et leur état.

Si la première exécution a modifié le schéma, mais a échoué avant d’enregistrer sa réussite, la deuxième exécution peut retenter une migration qui n’a pas été conçue pour être idempotente. Ne corrigez l’historique qu’après avoir comparé le schéma réel au résultat attendu de la migration.

Vérifiez les changements d’identité du journal des modifications et des sommes de contrôle

Comparez les noms de fichiers de migration, les ID, les auteurs, les chemins et les sommes de contrôle avant et après la mise à jour de l’image. Déterminez si l’image contient des entrées de journal des modifications dupliquées ou renommées.

Liquibase enregistre les modifications exécutées dans la table DATABASECHANGELOG, où l’identité d’une modification dépend de son ID, de son auteur et du chemin du fichier.

Déplacer un fichier de journal des modifications ou régénérer des identifiants peut faire passer d’anciens travaux pour de nouveaux, même si le code SQL est similaire. Rétablissez une identité stable pour les migrations au lieu de supprimer manuellement de larges plages de l’historique.

Redéployez avec un seul responsable des migrations et vérifiez l’idempotence

Choisissez un seul responsable des migrations, ajoutez un verrouillage durable, faites attendre les services web et worker jusqu’à la réussite de l’exécution, puis redéployez sur une copie de test de la base de données.

L’article de ZimaSpace sur les limites de planification des conteneurs présente la règle complémentaire : chaque tâche de maintenance doit avoir un seul responsable d’exécution confirmé.

Le problème est résolu lorsque des démarrages simultanés ou répétés produisent une seule migration appliquée, un seul enregistrement durable dans l’historique et aucune seconde modification du schéma après le redémarrage.

Questions fréquentes

L’exécution d’une migration deux fois endommage-t-elle toujours la base de données ?

Non. Les migrations idempotentes peuvent détecter en toute sécurité les objets existants, mais les transformations de données non idempotentes, la création d’index ou les modifications de colonnes peuvent échouer ou dupliquer des données.

Chaque réplique web devrait-elle pouvoir exécuter des migrations ?

Seulement si le framework assure une coordination fiable au niveau de la base de données. Dans un déploiement de serveur domestique, il est plus facile d’auditer un responsable unique et dédié aux migrations, exécuté une seule fois.

Puis-je marquer manuellement la migration comme terminée ?

Seulement après avoir prouvé que le schéma et les données en production correspondent au résultat attendu de la migration. Modifier l’historique en premier peut masquer une modification partiellement appliquée.

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.