fix(ogcore): fix scheduled task execution and UTC timezone handling #106

Merged
maranda merged 1 commits from fix_scheduled_tasks into main 2026-05-06 17:26:58 +02:00
Collaborator

fix(ogcore): scheduled task execution and UTC timezone handling

Summary

  • Reboot y run-script siempre fallaban silenciosamente: executeReboot
    y executeRunScript comprobaban json_decode(body)['status'] === 200
    contra el body de la respuesta (una entidad serializada), en lugar de
    getStatusCode() === 200. Las tareas se ejecutaban correctamente en el
    agente pero las trazas quedaban en estado PENDING para siempre,
    bloqueando el resto de la cola del cliente.

  • Deriva de zona horaria cliente/servidor: executionTime y
    executionDate se almacenaban tal como llegaban del cliente (con su
    timezone local). Si cliente y servidor tenían zonas horarias distintas,
    las tareas se agendaban a una hora incorrecta. Ahora se normalizan a UTC
    en el CommandTaskScheduleInput y todos los cálculos internos usan UTC.

  • Ventana de ejecución de 30 segundos demasiado frágil: si el cron
    fallaba o se retrasaba aunque fuera un minuto, la tarea quedaba perdida
    para siempre. Sustituida por la lógica isDue && notYetExecuted: se
    ejecuta si la hora ha llegado y no se ha ejecutado desde que fue
    programada.

  • Tareas únicas (none) aparecían en el log indefinidamente: después
    de ejecutarse, calculateNextExecutionDate devolvía la misma fecha
    pasada y nextExecution nunca quedaba en null. Añadido el filtro
    $execDateTime > $now para el tipo none, igual que ya existía para
    los tipos recurrentes.

Ficheros afectados

  • src/Command/ExecutePendingTracesCommand.php
  • src/Command/RunScheduledCommandTasksCommand.php
  • src/Dto/Input/CommandTaskScheduleInput.php
  • src/Entity/CommandTask.php

Test plan

  • Crear tarea programada de tipo reboot y verificar que la traza pasa
    a SUCCESS al ejecutar opengnsys:execute-pending-traces
  • Crear tarea de tipo run-script y verificar que la traza pasa a
    IN_PROGRESS (no PENDING)
  • Crear schedule enviando executionTime con offset +02:00 y
    comprobar que en BD queda almacenado en UTC (-2h)
  • Programar tarea para dentro de 2 minutos, detener el cron, esperar
    5 minutos, relanzar el cron y verificar que la tarea se ejecuta igualmente
  • Verificar que una tarea única (none) desaparece del log del cron
    tras ejecutarse
## fix(ogcore): scheduled task execution and UTC timezone handling ## Summary - **Reboot y run-script siempre fallaban silenciosamente**: `executeReboot` y `executeRunScript` comprobaban `json_decode(body)['status'] === 200` contra el body de la respuesta (una entidad serializada), en lugar de `getStatusCode() === 200`. Las tareas se ejecutaban correctamente en el agente pero las trazas quedaban en estado `PENDING` para siempre, bloqueando el resto de la cola del cliente. - **Deriva de zona horaria cliente/servidor**: `executionTime` y `executionDate` se almacenaban tal como llegaban del cliente (con su timezone local). Si cliente y servidor tenían zonas horarias distintas, las tareas se agendaban a una hora incorrecta. Ahora se normalizan a UTC en el `CommandTaskScheduleInput` y todos los cálculos internos usan UTC. - **Ventana de ejecución de 30 segundos demasiado frágil**: si el cron fallaba o se retrasaba aunque fuera un minuto, la tarea quedaba perdida para siempre. Sustituida por la lógica `isDue && notYetExecuted`: se ejecuta si la hora ha llegado y no se ha ejecutado desde que fue programada. - **Tareas únicas (`none`) aparecían en el log indefinidamente**: después de ejecutarse, `calculateNextExecutionDate` devolvía la misma fecha pasada y `nextExecution` nunca quedaba en `null`. Añadido el filtro `$execDateTime > $now` para el tipo `none`, igual que ya existía para los tipos recurrentes. ## Ficheros afectados - `src/Command/ExecutePendingTracesCommand.php` - `src/Command/RunScheduledCommandTasksCommand.php` - `src/Dto/Input/CommandTaskScheduleInput.php` - `src/Entity/CommandTask.php` ## Test plan - [ ] Crear tarea programada de tipo `reboot` y verificar que la traza pasa a `SUCCESS` al ejecutar `opengnsys:execute-pending-traces` - [ ] Crear tarea de tipo `run-script` y verificar que la traza pasa a `IN_PROGRESS` (no `PENDING`) - [ ] Crear schedule enviando `executionTime` con offset `+02:00` y comprobar que en BD queda almacenado en UTC (`-2h`) - [ ] Programar tarea para dentro de 2 minutos, detener el cron, esperar 5 minutos, relanzar el cron y verificar que la tarea se ejecuta igualmente - [ ] Verificar que una tarea única (`none`) desaparece del log del cron tras ejecutarse
narenas added 1 commit 2026-05-06 15:35:16 +02:00
testing/ogcore-api/pipeline/head There was a failure building this commit Details
testing/ogcore-api/pipeline/pr-main There was a failure building this commit Details
a8cdae154b
fix(ogcore): fix scheduled task execution and UTC timezone handling
- Fix executeReboot response check: use getStatusCode() instead of
  json_decode(body)['status'], which never matched the Client entity body
- Fix executeRunScript: same check fix; remove duplicate trace status
  update since RunScriptAction already handles it via updateExistingTrace
- Normalize executionDate/executionTime to UTC at API boundary in
  CommandTaskScheduleInput to prevent client/server timezone drift
- Use UTC consistently in calculateNextExecutionDate and
  RunScheduledCommandTasksCommand for all datetime comparisons
- Replace 30-second execution window (abs(difference) < 30) with
  isDue && notYetExecuted logic so tasks missed by the cron are
  recovered in the next cycle instead of being skipped forever
- Skip one-time (none) tasks with a past executionDate in
  calculateNextExecutionDate so nextExecution is set to null after
  execution and the task no longer appears in cron logs
maranda merged commit c1da9387da into main 2026-05-06 17:26:58 +02:00
Sign in to join this conversation.
No reviewers
No Label
No Milestone
No project
No Assignees
1 Participants
Notifications
Due Date
The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: opengnsys/ogcore#106
There is no content yet.