DevOps & Monitoring

ChronoStack bringt virtuelle Zeitsteuerung in Docker-Compose-Tests

Ein neues Alpha-Tool synchronisiert Uhren über Postgres, Redis und Anwendungsdienste hinweg in Docker Compose, um zeitabhängige Logik ohne Codeänderungen zu testen.

Eine Sanduhr auf einem Serverschrank mit digitalem Sand
Für diesen Artikel erstellte Illustration

Automatisch aus dem englischen Original übersetzt.

Der GitHub-Nutzer Asmodeus14 hat ChronoStack veröffentlicht, ein Utility im Alpha-Stadium, das entwickelt wurde, um den Zeitablauf über gesamte Docker-Compose-Stacks hinweg zu simulieren. Dieses am 20. November 2026 veröffentlichte Tool ermöglicht es Entwicklern, virtuelle Uhren für PostgreSQL, Redis und verschiedene Anwendungs-Runtimes gleichzeitig vorzustellen, was rigoroses Testen von geplanten Jobs und zeitkritischen Workflows erlaubt.

Was passiert ist

ChronoStack adressiert eine persistente Herausforderung in der Softwareentwicklung: Das Testen von Logik, die vom Zeitablauf abhängt, wie etwa Ablaufdaten von Testzeiträumen, Verlängerungen von Abonnements und die Planung von Hintergrund-Jobs. Traditionell haben Ingenieure auf manuelle Datenbank-Timestamp-Bearbeitungen oder umgebungsspezifische Flags zurückgegriffen – Methoden, die oft scheitern, die komplexen Interaktionen zwischen Datenbankfunktionen, Cache-Abläufen und Anwendungsschedulern nachzubilden. Dieses neue Tool führt eine einheitliche virtuelle Uhr ein, die die Zeitwahrnehmung für jeden Dienst in einem Stack steuert, ohne dass Änderungen am Quellcode der Anwendung erforderlich sind.

Das Tool funktioniert, indem es eine isolierte Kopie der bestehenden Docker-Compose-Konfiguration erstellt, wodurch sichergestellt wird, dass Produktionsdaten und Konfigurationen unberührt bleiben. Es nutzt eine kleine C-Bibliothek, die über LD_PRELOAD injiziert wird, um Wall-Clock-Lesungen (Systemzeit) in unterstützten Sprachen abzufangen, darunter Node.js, Python, Ruby, PHP, .NET und JVM-basierte Anwendungen. Dieser Ansatz fügt eine vernachlässigbare Latenz hinzu, gemessen bei etwa 12–16 Nanosekunden pro Lesevorgang in C und etwas höher in interpretierten Sprachen, während monotone Uhren und absolute Fristen intakt bleiben, um Timeout-Hänger zu verhindern.

Über einfaches Zeitverschieben hinaus enthält ChronoStack Orchestrierungsfunktionen, die die Ausführung geplanter Aufgaben verwalten. Wenn die virtuelle Uhr vorrückt, pausiert das Tool an bestimmten Intervallen, um Cron-Jobs auszulösen, Nachrichten-Warteschlangen wie BullMQ oder Sidekiq zu leeren und zu überprüfen, ob alle Dienste die neue Zeit erkennen. Es unterstützt auch die Simulation von HTTP-Ausfällen während bestimmter virtueller Zeitfenster, sodass Teams testen können, wie ihre Systeme externe Abhängigkeitsausfälle neben interner zeitbasierter Logik handhaben.

Wichtige Details

  • Keine Codeänderungen: Das Tool funktioniert mit bestehenden compose.yml-Dateien, indem separate Container und benannte Volumes erstellt werden, wobei Originaldateien und Bind-Mounts vor versehentlicher Änderung geschützt bleiben.
  • Mehrsprachenunterstützung: Getestet in CI für PostgreSQL 16, Redis 7, Node.js 22, Python 3.10/3.12, JVM 17/21, Ruby 3.3, PHP 8.3 und .NET 8.
  • Scheduler-Erkennung: Erkennt und behandelt automatisch pg_cron, BullMQ und Celery beat, um sicherzustellen, dass Jobs zu ihren korrekten virtuellen Zeiten feuern und nicht während Zeitsprüngen übersprungen werden.
  • Sicherheitsmechanismen: Die API ist nur lokal verfügbar mit Token-Authentifizierung, erfordert keine privilegierten Container und greift niemals auf die reale Uhr des Host-Rechners oder den Docker-Socket zu.
  • Szenario-Skripting: Benutzer können YAML-basierte Testszenarien definieren, die Fehlerinjektion, Zeitschritte und Assertions gegen SQL-, Redis- oder HTTP-Zustände enthalten.
  • Plattformkompatibilität: Vollständig getestet auf Linux x86_64/arm64, Windows 11 und macOS Intel; die Unterstützung für Container auf macOS Apple Silicon ist derzeit ungetestet und sucht nach Community-Validierung.

Hintergrund

Das Testen zeitabhängigen Codes ist notorisch schwierig, da Unit-Tests die Zeit typischerweise innerhalb eines einzelnen Prozesses mocken und dabei die verteilte Natur moderner Anwendungen ignorieren. In einem typischen Stack verwendet eine Datenbank möglicherweise ihre eigene interne Uhr für now()-Funktionen, während eine Cache-Ebene wie Redis Abläufe unabhängig verfolgt und Anwendungsserver für die Planung auf die Systemzeit angewiesen sind. Diskrepanzen zwischen diesen Uhren können zu subtilen Bugs führen, wie etwa dem vorzeitigen Löschen von Datensätzen oder dem Überspringen von Zyklen wiederkehrender Aufgaben.

ChronoStack baut auf Konzepten auf, die Stripe’s Test Clocks ähneln, erweitert diese jedoch auf den gesamten Infrastruktur-Stack. Durch die Nutzung von LD_PRELOAD fängt es Systemaufrufe auf Bibliotheksebene ab und zwingt alle unterstützten Prozesse dazu, sich auf einen einzigen virtuellen Zeitstrahl zu einigen. Dies stellt sicher, dass wenn ein Entwickler die Zeit um vierzehn Tage vorstellt, die Datenbank, der Cache und die Anwendungslogik alle denselben vierzehntägigen Sprung gleichzeitig wahrnehmen und so die Konsistenz in der Integrationsumgebung gewahrt bleibt.

Warum es wichtig ist

Für Teams, die Self-Hosted-Software betreiben oder SaaS-Produkte entwickeln, ist die Zuverlässigkeit von Billing- und Retention-Logik kritisch. Bugs in diesen Bereichen, wie sie in Projekten wie Saleor und Twenty während der frühen Tests von ChronoStack identifiziert wurden, können zu Umsatzverlust oder Problemen mit der Datenintegrität führen. Die Fähigkeit, einen vierzehntägigen Testzeitraum reproduzierbar zu skripten und zu verifizieren, dass Ablauf-E-Mails gesendet und Zugriffe widerrufen werden, bietet ein Maß an Vertrauen, das manuelles Testen nicht erreichen kann.

Darüber hinaus ermöglicht die Fähigkeit des Tools, Ausfälle in virtueller Zeit zu simulieren, Ingenieuren das Testen von Resilienz-Mustern, ohne auf reale Ausfälle warten zu müssen. Indem deklariert wird, dass ein externer Webhook-Provider für ein spezifisches vierstündiges Fenster in der Zukunft ausgefallen ist, können Entwickler verifizieren, dass Retry-Logik und Fallback-Mechanismen korrekt funktionieren. Dies reduziert die Notwendigkeit komplexer, fragiler Test-Harnesses und ermöglicht robustere Continuous-Integration-Pipelines.

Was Sie tun können

  • Installieren Sie die neueste Alpha-Version (v0.1.0-alpha.7) unter Verwendung des bereitgestellten Shell-Skripts oder Paketmanagern wie Homebrew und Scoop.
  • Führen Sie die enthaltene SaaS-Test-Demo aus, um zu beobachten, wie ein Vorrücken um vierzehn Tage nächtliche Jobs auslöst und Benutzertestzeiträume automatisch ablaufen lässt.
  • Initialisieren Sie ChronoStack in Ihrem eigenen Projektverzeichnis mit chronostack init, um eine Startkonfiguration für Ihre Scheduler zu generieren.
  • Verwenden Sie den Befehl chronostack doctor nach dem Start des Stacks, um zu verifizieren, dass alle Dienste korrekt mit der virtuellen Uhr verbunden sind.
  • Tragen Sie zum Projekt bei, indem Sie auf macOS Apple Silicon Hardware testen oder Ihre aktuellen Strategien zum Testen zeitabhängigen Codes teilen.
  • Überprüfen Sie die dokumentierten Einschränkungen, wie die fehlende Unterstützung für Go-Binaries und die ausschließlich vorwärtsgerichtete Bewegung der Zeit, um die Kompatibilität mit Ihrem Stack sicherzustellen.

Weitere News

Alle News