ChronoStack introduce el control virtual del tiempo en las pruebas de Docker Compose
Una nueva herramienta alpha sincroniza los relojes de Postgres, Redis y los servicios de aplicación en Docker Compose para probar la lógica dependiente del tiempo sin cambios en el código.
Traducido automáticamente del original en inglés.
El usuario de GitHub Asmodeus14 ha lanzado ChronoStack, una utilidad en fase alpha diseñada para simular el paso del tiempo en stacks completos de Docker Compose. Publicado el 20 de noviembre de 2026, esta herramienta permite a los desarrolladores avanzar los relojes virtuales de PostgreSQL, Redis y varios entornos de ejecución de aplicaciones simultáneamente, lo que facilita pruebas rigurosas de trabajos programados y flujos de trabajo sensibles al tiempo.
Qué ha ocurrido
ChronoStack aborda un desafío persistente en el desarrollo de software: probar la lógica que depende del paso del tiempo, como las expiraciones de periodos de prueba, las renovaciones de suscripciones y la programación de trabajos en segundo plano. Tradicionalmente, los ingenieros han confiado en ediciones manuales de marcas de tiempo en la base de datos o en flags específicos del entorno, métodos que a menudo no logran replicar las interacciones complejas entre funciones de base de datos, caducidad de caché y planificadores de aplicaciones. Esta nueva herramienta introduce un reloj virtual unificado que controla la percepción del tiempo para cada servicio en un stack sin requerir modificaciones en el código fuente de la aplicación.
La herramienta funciona creando una copia aislada de la configuración existente de Docker Compose, asegurando que los datos y configuraciones de producción permanezcan intactos. Utiliza una pequeña librería C inyectada mediante LD_PRELOAD para interceptar las lecturas del reloj de pared (wall-clock) en lenguajes compatibles, incluyendo Node.js, Python, Ruby, PHP, .NET y aplicaciones basadas en JVM. Este enfoque añade una latencia insignificante, medida en aproximadamente 12–16 nanosegundos por lectura en C y ligeramente superior en lenguajes interpretados, mientras deja intactos los relojes monótonos y los plazos absolutos para evitar cuelgues por timeout.
Más allá del simple desplazamiento temporal, ChronoStack incluye funciones de orquestación que gestionan la ejecución de tareas programadas. Cuando el reloj virtual avanza, la herramienta se detiene en intervalos específicos para activar cron jobs, vaciar colas de mensajes como BullMQ o Sidekiq, y verificar que todos los servicios reconozcan la nueva hora. También admite la simulación de cortes HTTP durante ventanas de tiempo virtual específicas, permitiendo a los equipos probar cómo sus sistemas manejan fallos de dependencias externas junto con la lógica interna basada en el tiempo.
Detalles clave
- Sin cambios en el código: La herramienta funciona con archivos
compose.ymlexistentes creando contenedores separados y volúmenes nombrados, protegiendo los archivos originales y los bind mounts de modificaciones accidentales. - Soporte multi-lenguaje: Probado en CI para PostgreSQL 16, Redis 7, Node.js 22, Python 3.10/3.12, JVM 17/21, Ruby 3.3, PHP 8.3 y .NET 8.
- Conciencia del planificador: Detecta y gestiona automáticamente pg_cron, BullMQ y Celery beat, asegurando que los trabajos se ejecuten en sus tiempos virtuales correctos en lugar de ser omitidos durante saltos temporales.
- Mecanismos de seguridad: La API es solo local con autenticación por token, no requiere contenedores privilegiados y nunca accede al reloj real de la máquina anfitriona ni al socket de Docker.
- Scripting de escenarios: Los usuarios pueden definir escenarios de prueba basados en YAML que incluyen inyección de fallos, pasos de avance temporal y aserciones contra estados SQL, Redis o HTTP.
- Compatibilidad de plataforma: Totalmente probado en Linux x86_64/arm64, Windows 11 y macOS Intel; el soporte de contenedores en Apple Silicon para macOS aún no está probado y busca validación comunitaria.
Contexto
Probar código dependiente del tiempo es notoriamente difícil porque las pruebas unitarias suelen simular el tiempo dentro de un único proceso, ignorando la naturaleza distribuida de las aplicaciones modernas. En un stack típico, una base de datos podría usar su propio reloj interno para funciones now(), mientras que una capa de caché como Redis rastrea la caducidad de forma independiente, y los servidores de aplicación dependen del tiempo del sistema para la programación. Las discrepancias entre estos relojes pueden llevar a errores sutiles, como el borrado prematuro de registros o la omisión de ciclos en tareas recurrentes.
ChronoStack se basa en conceptos similares a los Test Clocks de Stripe, pero los extiende a todo el stack de infraestructura. Al utilizar LD_PRELOAD, intercepta llamadas al sistema a nivel de librería, forzando a todos los procesos compatibles a acordar una única línea de tiempo virtual. Esto garantiza que cuando un desarrollador avanza el tiempo catorce días, la base de datos, la caché y la lógica de la aplicación perciban ese mismo salto de catorce días simultáneamente, manteniendo la consistencia en el entorno de integración.
Por qué importa
Para equipos que ejecutan software autoalojado o desarrollan productos SaaS, la fiabilidad en la lógica de facturación y retención es crítica. Los errores en estas áreas, como los identificados en proyectos como Saleor y Twenty durante las primeras pruebas de ChronoStack, pueden provocar pérdidas de ingresos o problemas de integridad de datos. La capacidad de scriptear de forma reproducible un periodo de prueba de catorce días y verificar que se envían correos de expiración y se revoca el acceso ofrece un nivel de confianza que las pruebas manuales no pueden igualar.
Además, la capacidad de la herramienta para simular cortes en tiempo virtual permite a los ingenieros probar patrones de resiliencia sin esperar a fallos del mundo real. Al declarar que un proveedor externo de webhooks está caído durante una ventana específica de cuatro horas en el futuro, los desarrolladores pueden verificar que la lógica de reintentos y los mecanismos de fallback funcionan correctamente. Esto reduce la necesidad de arneses de prueba complejos y frágiles, habilitando pipelines de integración continua más robustos.
Qué puedes hacer
- Instala la última versión alpha (v0.1.0-alpha.7) utilizando el script shell proporcionado o gestores de paquetes como Homebrew y Scoop.
- Ejecuta la demo incluida de prueba SaaS para observar cómo un avance de catorce días activa trabajos nocturnos y expira automáticamente los periodos de prueba de los usuarios.
- Inicializa ChronoStack en tu directorio de proyecto usando
chronostack initpara generar una configuración inicial para tus planificadores. - Usa el comando
chronostack doctordespués de iniciar el stack para verificar que todos los servicios están correctamente conectados al reloj virtual. - Contribuye al proyecto probándolo en hardware macOS Apple Silicon o compartiendo tus estrategias actuales para probar código dependiente del tiempo.
- Revisa las limitaciones documentadas, como la falta de soporte para binarios Go y el movimiento únicamente hacia adelante del tiempo, para asegurar la compatibilidad con tu stack.



