# Tarea de consola programada con systemd En esta guía escribirá un proceso nocturno que recalcula el saldo de cada cliente a partir de sus cargos pendientes, con bitácora en la salida, manejo de errores por registro y un código de salida que indica si falló. Luego lo programará con un *timer* de systemd y verá cómo revisar sus ejecuciones. Requisitos: Devkron 2.0 en `/opt/devkron` en Linux, un usuario de servicio `devkron` ([Servicio en Linux](/es/devkron/2.0/instalacion/servicio-linux.md)) y la base `tienda2` de la guía [CRUD con MySQL](/es/devkron/2.0/guias/crud-mysql.md) con la conexión `principal@tienda2`. ## 1. Los datos Una tabla de cargos para el ejemplo: ```sql create table cargo ( sys_pk int auto_increment primary key, icliente int not null, fecha date not null, importe decimal(14,2) not null, pagado tinyint not null default 0 ); insert into cargo(icliente, fecha, importe, pagado) values (1,'2026-10-01',1200,0), (1,'2026-10-05',300.5,0), (1,'2026-09-20',500,1), (4,'2026-10-10',800,0); ``` ## 2. El programa `/opt/devkron/tareas/tienda/saldos.dkl`: ```dkl #include "dkli.dkh" #! program "Recalcular saldos de clientes" { #include "functions.dkh" #include "serialize.dkh" #include "dbr.dkh" do errordet(@false) bitacora::mensaje { do print(date_str(now(),"yyyy-MM-dd HH:mm:ss") + " " + mensaje) } ref db = @null ref db = dbr.login("principal@tienda2", "web", "MiClave#2026") do bitacora("Inicio") ref clientes = dbr.list(db, "select sys_pk, codigo from cliente where ifnull(sys_deleted,0)=0;", @null) actualizados = 0 errores = 0 for i=0; i<@count(clientes) { ref c = @item(clientes, i) new p { @"id": @@(c,"#sys_pk") } codeblock { saldo = dbr.num(db, "select ifnull(sum(importe),0) from cargo where icliente=@id and pagado=0;", p) p<"saldo">: saldo do dbr.execute(db, "update cliente set saldo=@saldo where sys_pk=@id;", p) actualizados = actualizados + 1 do bitacora(@@(c,"$codigo") + ": " + format(saldo,"#,0.00")) exception { errores = errores + 1 do bitacora("Error con " + @@(c,"$codigo") + ": " + last_error()) } } } do bitacora("Clientes actualizados: " + str(actualizados) + ", con error: " + str(errores)) do dbr.close(db) if errores > 0 { do rise_error(1, "Hubo " + str(errores) + " errores") } exception { do bitacora("Falla: " + last_error()) if not(isnull(db)) { do dbr.close(db) } do rise_error(1, last_error()) } } ``` Cómo está armado: - **Un error en un cliente no detiene a los demás**: cada uno va en su propio `codeblock` con `exception`, que cuenta y anota el error. - **Un error general** (no conecta, la consulta falla) lo atrapa el `exception` del programa, que lo anota y lo vuelve a lanzar. Un error no atendido hace que `dkl` termine con **código de salida 1**: así systemd, cron o un script saben que la tarea falló. (En Devkron 1.x el código era siempre 0.) - Si hubo errores en algún cliente, el programa también termina con error al final, para que se note en el monitoreo. - Cada cliente se guarda por separado. Si necesita todo o nada, use una transacción ([Transacciones bien hechas](/es/devkron/2.0/guias/transacciones.md)). ## 3. Pruébelo a mano Ejecute desde la carpeta de la instalación (ahí busca `connections.xml`, y también junto a los ensamblados de Devkron): ```bash cd /opt/devkron sudo -u devkron DEVKRON_CULTURE=es-MX ./dkl tareas/tienda/saldos.dkl -hide-log; echo "código de salida: $?" ``` Salida real: ```text 2026-10-27 18:22:39 Inicio 2026-10-27 18:22:39 CLI-0001: 1,500.50 2026-10-27 18:22:39 CLI-0003: 800.00 2026-10-27 18:22:39 Clientes actualizados: 2, con error: 0 código de salida: 0 ``` Con una contraseña incorrecta en `dbr.login`, la salida real es: ```text 2026-10-27 18:22:40 Falla: Error en 'dbr.login. (Error de inicio de sesión, verifique Usuario y ContraseñaException has been thrown by the target of an invocation.) [saldos-mal.dkl] Error en 'dbr.login. (Error de inicio de sesión, verifique Usuario y ContraseñaException has been thrown by the target of an invocation.) [saldos-mal.dkl] código de salida: 1 ``` - `-hide-log` quita las líneas `Iniciado`, `ID de ejecución` y `Terminado` de la consola. - `DEVKRON_CULTURE=es-MX` fija la cultura de presentación (`1,500.50`); sin ella se usa la del sistema ([Cultura](/es/devkron/2.0/migracion/cultura.md)). - El usuario de la tarea tiene su propia caché de compilados; no comparte la del servicio FastCGI, y eso es normal. ## 4. El servicio y el timer de systemd `/etc/systemd/system/tienda-saldos.service`: ```ini [Unit] Description=Tienda: recalcular saldos de clientes After=network.target mysql.service [Service] Type=oneshot User=devkron Group=devkron WorkingDirectory=/opt/devkron Environment=DEVKRON_CULTURE=es-MX ExecStart=/opt/devkron/dkl /opt/devkron/tareas/tienda/saldos.dkl -hide-log ``` `/etc/systemd/system/tienda-saldos.timer`: ```ini [Unit] Description=Tienda: recalcular saldos cada noche [Timer] OnCalendar=*-*-* 02:15:00 Persistent=true RandomizedDelaySec=120 [Install] WantedBy=timers.target ``` - `Type=oneshot`: el servicio corre y termina; systemd registra su código de salida. - `OnCalendar=*-*-* 02:15:00`: todos los días a las 2:15. Compruebe una expresión con `systemd-analyze calendar "*-*-* 02:15:00"` (muestra la siguiente ejecución). - `Persistent=true`: si el servidor estaba apagado a esa hora, la tarea corre al arrancar. - `RandomizedDelaySec`: evita que varias tareas arranquen en el mismo segundo. Las dos unidades se validaron con `systemd-analyze verify` (sin errores de sintaxis). ```bash sudo systemctl daemon-reload sudo systemctl enable --now tienda-saldos.timer systemctl list-timers tienda-saldos.timer # siguiente y última ejecución sudo systemctl start tienda-saldos.service # ejecutarla ahora journalctl -u tienda-saldos.service -n 50 # su bitácora (la salida de do print) systemctl status tienda-saldos.service # resultado de la última ejecución ``` Si la última ejecución terminó con código 1, `systemctl status` la muestra como `failed` y `systemctl --failed` la lista: conéctelo a su monitoreo. ### Con cron Si prefiere cron, la línea equivalente para el usuario `devkron` (`crontab -u devkron -e`): ```text 15 2 * * * cd /opt/devkron && DEVKRON_CULTURE=es-MX ./dkl tareas/tienda/saldos.dkl -hide-log >> /var/log/devkron/saldos.log 2>&1 ``` ## 5. Bitácora en archivo `do print` deja la bitácora en el journal de systemd. Si la necesita en archivos, uno por día, use la biblioteca estándar [log.dkh](/es/devkron/2.0/bibliotecas/estandar/log.md). Para procesar miles de registros en paralelo, vea [threads.dkh](/es/devkron/2.0/bibliotecas/estandar/threads.md). ## Errores típicos | Síntoma | Causa y solución | |---|---| | `El nombre de la aplicación no se encuentra en el repositorio` | La tarea no encuentra `connections.xml`: ponga `WorkingDirectory=/opt/devkron` o deje el archivo junto a los ensamblados | | Funciona a mano pero no en systemd | Otro usuario u otra carpeta de trabajo: pruebe con `sudo -u devkron` desde `/opt/devkron` | | systemd la marca como correcta aunque falló | El error se atrapó con `exception` y no se volvió a lanzar: termine con `rise_error` | | Números con otro formato que en la web | Falta `DEVKRON_CULTURE` en la unidad (la cultura del servicio FastCGI va en `fastcgi.json`) |