ChronoStack apporte un contrôle du temps virtuel aux tests Docker Compose
Un nouvel outil alpha synchronise les horloges de Postgres, Redis et des services applicatifs dans Docker Compose pour tester la logique dépendante du temps sans modifier le code.
Traduit automatiquement depuis l’original en anglais.
L'utilisateur GitHub Asmodeus14 a publié ChronoStack, un utilitaire en phase alpha conçu pour simuler l'écoulement du temps sur l'ensemble des stacks Docker Compose. Publiée le 20 novembre 2026, cette outil permet aux développeurs d'avancer simultanément les horloges virtuelles de PostgreSQL, Redis et divers environnements d'exécution applicatifs, facilitant ainsi des tests rigoureux des tâches planifiées et des workflows sensibles au temps.
Ce qui s'est passé
ChronoStack répond à un défi persistant dans le développement logiciel : tester la logique dépendante de l'écoulement du temps, comme les expirations d'essais gratuits, les renouvellements d'abonnements et la planification de tâches en arrière-plan. Traditionnellement, les ingénieurs ont eu recours à des modifications manuelles des horodatages de base de données ou à des indicateurs spécifiques à l'environnement, des méthodes qui ne parviennent souvent pas à reproduire les interactions complexes entre les fonctions de base de données, l'expiration des caches et les ordonnanceurs d'applications. Ce nouvel outil introduit une horloge virtuelle unifiée qui contrôle la perception du temps pour chaque service d'une stack sans nécessiter de modifications du code source de l'application.
L'outil fonctionne en créant une copie isolée de la configuration Docker Compose existante, garantissant que les données et configurations de production restent intactes. Il utilise une petite bibliothèque C injectée via LD_PRELOAD pour intercepter les lectures de l'horloge murale dans les langages pris en charge, notamment Node.js, Python, Ruby, PHP, .NET et les applications basées sur JVM. Cette approche ajoute une latence négligeable, mesurée à environ 12–16 nanosecondes par lecture en C et légèrement plus élevée dans les langages interprétés, tout en laissant les horloges monotones et les délais absolus intacts pour éviter les blocages dus aux timeouts.
Au-delà du simple décalage temporel, ChronoStack inclut des fonctionnalités d'orchestration qui gèrent l'exécution des tâches planifiées. Lorsque l'horloge virtuelle avance, l'outil marque des pauses à des intervalles spécifiques pour déclencher les jobs cron, vider les files de messages comme BullMQ ou Sidekiq, et vérifier que tous les services reconnaissent la nouvelle heure. Il prend également en charge la simulation de pannes HTTP pendant des fenêtres de temps virtuelles spécifiques, permettant aux équipes de tester comment leurs systèmes gèrent les défaillances des dépendances externes parallèlement à la logique interne basée sur le temps.
Détails clés
- Zéro modification de code : L'outil fonctionne avec les fichiers
compose.ymlexistants en créant des conteneurs séparés et des volumes nommés, protégeant ainsi les fichiers originaux et les points de montage bind contre toute modification accidentelle. - Prise en charge multi-langages : Testé en CI pour PostgreSQL 16, Redis 7, Node.js 22, Python 3.10/3.12, JVM 17/21, Ruby 3.3, PHP 8.3 et .NET 8.
- Conscience des ordonnanceurs : Détecte et gère automatiquement pg_cron, BullMQ et Celery beat, garantissant que les jobs se déclenchent à leurs heures virtuelles correctes plutôt que d'être ignorés lors des sauts temporels.
- Mécanismes de sécurité : L'API est uniquement locale avec authentification par jeton, ne nécessite pas de conteneurs privilégiés et n'accède jamais à l'horloge réelle de la machine hôte ni au socket Docker.
- Scripting de scénarios : Les utilisateurs peuvent définir des scénarios de test basés sur YAML qui incluent l'injection de fautes, les étapes d'avancement du temps et les assertions contre les états SQL, Redis ou HTTP.
- Compatibilité plateforme : Entièrement testé sur Linux x86_64/arm64, Windows 11 et macOS Intel ; la prise en charge des conteneurs sur macOS Apple Silicon n'est actuellement pas testée et recherche une validation communautaire.
Contexte
Tester le code dépendant du temps est notoirement difficile car les tests unitaires simulent généralement le temps au sein d'un seul processus, ignorant la nature distribuée des applications modernes. Dans une stack typique, une base de données peut utiliser sa propre horloge interne pour les fonctions now(), tandis qu'une couche de cache comme Redis suit l'expiration indépendamment, et les serveurs applicatifs dépendent du temps système pour la planification. Les divergences entre ces horloges peuvent entraîner des bugs subtils, tels que la suppression prématurée d'enregistrements ou le saut de cycles par des tâches récurrentes.
ChronoStack s'appuie sur des concepts similaires aux Test Clocks de Stripe mais les étend à l'ensemble de la stack d'infrastructure. En utilisant LD_PRELOAD, il intercepte les appels système au niveau de la bibliothèque, forçant tous les processus pris en charge à convenir d'une seule chronologie virtuelle. Cela garantit que lorsqu'un développeur avance le temps de quatorze jours, la base de données, le cache et la logique applicative perçoivent tous ce même saut de quatorze jours simultanément, maintenant la cohérence dans l'environnement d'intégration.
Pourquoi c'est important
Pour les équipes exécutant des logiciels auto-hébergés ou développant des produits SaaS, la fiabilité de la logique de facturation et de rétention est critique. Les bugs dans ces domaines, tels que ceux identifiés dans des projets comme Saleor et Twenty lors des premiers tests de ChronoStack, peuvent entraîner des pertes de revenus ou des problèmes d'intégrité des données. La capacité de scripter de manière reproductible une période d'essai de quatorze jours et de vérifier que les e-mails d'expiration sont envoyés et que l'accès est révoqué offre un niveau de confiance que les tests manuels ne peuvent égaler.
De plus, la capacité de l'outil à simuler des pannes dans le temps virtuel permet aux ingénieurs de tester les modèles de résilience sans attendre les défaillances du monde réel. En déclarant qu'un fournisseur de webhook externe est indisponible pendant une fenêtre spécifique de quatre heures dans le futur, les développeurs peuvent vérifier que la logique de retry et les mécanismes de secours fonctionnent correctement. Cela réduit le besoin de harnesses de test complexes et fragiles et permet des pipelines d'intégration continue plus robustes.
Ce que vous pouvez faire
- Installez la dernière version alpha (v0.1.0-alpha.7) en utilisant le script shell fourni ou des gestionnaires de paquets comme Homebrew et Scoop.
- Exécutez la démo d'essai SaaS incluse pour observer comment une avance de quatorze jours déclenche les jobs nocturnes et expire automatiquement les essais utilisateurs.
- Initialisez ChronoStack dans votre propre répertoire de projet en utilisant
chronostack initpour générer une configuration de départ pour vos ordonnanceurs. - Utilisez la commande
chronostack doctoraprès avoir démarré la stack pour vérifier que tous les services sont correctement connectés à l'horloge virtuelle. - Contribuez au projet en testant sur du matériel macOS Apple Silicon ou en partageant vos stratégies actuelles pour tester le code dépendant du temps.
- Consultez les limitations documentées, telles que l'absence de prise en charge des binaires Go et le mouvement uniquement vers l'avant du temps, pour assurer la compatibilité avec votre stack.



