Tareas programadas

¿Qué permite hacer?

• Correr un comando con un horario: cada N minutos, a una hora fija, ciertos días o con los atajos hourly, daily y weekly.
• Ejecutar la tarea una vez en el momento, o cortar una ejecución en curso.
• Cambiar el comando o el horario de una tarea existente.
• Ver la próxima y la última ejecución, y leer los logs del comando y del timer.

¿Cuándo conviene usarlo?

• Limpiezas, exportaciones o sincronizaciones periódicas que no son de una app de ArduMaker.
• Un script que tiene que correr aunque el VPS haya estado apagado a esa hora (se ejecuta al encender).

¿Cómo funciona en ArduMaker?

Validaciones antes de tocar el VPS

• Nombre: las mismas reglas que un servicio systemd (nombre_invalido).
• Comando: una sola línea, hasta 4000 caracteres, con comillas cerradas (comando_invalido). Si usa tuberías, &&, variables, redirecciones o comandos internos de la shell, se envuelve solo en /bin/sh -c "…" con el escape necesario.
• Horario: una expresión OnCalendar (daily, *-*-* 02:00:00, Mon..Fri *-*-* 10:00, *-*-* *:0/5:00 Europe/Madrid). Atajos: 5 o */5 significan cada 5 minutos, y 1 cada minuto.
• El error de validación dice qué campo falló en data.fields.

Alta

1. Se guardan copias de la unidad y del timer si ya existían.
2. Se escribe /etc/systemd/system/<nombre>.service (Type=oneshot, salida al journal con el nombre de la tarea) y /etc/systemd/system/<nombre>.timer (OnCalendar, Persistent=true).
3. daemon-reload, se arranca el timer y se habilita al inicio. Si un paso falla, se borra lo nuevo y se restauran las copias.
4. Con start=true el comando corre además una vez en ese momento (si esa ejecución falla, la tarea igual queda creada).

Editar, controlar y borrar

• Editar lee el comando y el horario actuales, borra la tarea y la vuelve a crear con lo nuevo. La tarea editada queda habilitada.
• `start` corre el comando ahora; `stop` corta esa ejecución (no detiene el timer).
• `enable` y `disable` cambian si el timer arranca con el sistema. disable no detiene un timer que ya está activo: sigue disparando hasta el próximo reinicio del VPS.
• Borrar detiene y deshabilita el timer, quita los dos archivos y recarga systemd. No hay nombres protegidos.

¿Qué cambia realmente?

• /etc/systemd/system/<nombre>.service y /etc/systemd/system/<nombre>.timer, con permisos 644.
• El comando corre como root, y su salida queda en el journal identificada con el nombre de la tarea.
• Una entrada en el registro de actividad del VPS por cada alta, edición, acción y borrado.

# <nombre>.timer
[Unit]
Description=Timer for task: limpieza

[Timer]
OnCalendar=*-*-* 02:00:00
Unit=limpieza.service
Persistent=true

[Install]
WantedBy=timers.target

Esquema

Resultado esperado

• Crear, editar y controlar devuelven timer_status, is_enabled y, salvo al crear, next_run.
• ver_tarea_vps muestra el contenido del servicio y del timer, el estado, la próxima y la última ejecución.
• ver_logs_tarea_vps con log_type: "service" muestra la salida del comando; con "timer", la del timer.

systemctl list-timers --no-pager
journalctl -u limpieza.service -n 50 --no-pager

Errores y resolución

Crear con el mismo nombre reemplaza la tarea; reintentar tras un corte es seguro con la misma idempotency_key. controlar_tarea_vps con start vuelve a correr el comando cada vez.

Relación con MCP

Sí, en los perfiles /mcp y /mcp/vps.

Referencia en /mcp/docs y ejemplos en /mcp/servicios.

Funciones relacionadas

• Servicios systemd
• Copias de seguridad
• Monitorización
• Servidores VPS