Tarefas agendadas

O que permite fazer?

• Correr um comando com horário: a cada N minutos, a uma hora fixa, em certos dias ou com os atalhos hourly, daily e weekly.
• Executar a tarefa uma vez no momento, ou interromper uma execução em curso.
• Mudar o comando ou o horário de uma tarefa existente.
• Ver a próxima e a última execução, e ler os logs do comando e do timer.

Quando convém usar?

• Limpezas, exportações ou sincronizações periódicas que não são de uma app da ArduMaker.
• Um script que tem de correr mesmo que o VPS estivesse desligado a essa hora (executa ao ligar).

Como funciona na ArduMaker?

Validações antes de tocar no VPS

• Nome: as mesmas regras que um serviço systemd (nombre_invalido).
• Comando: uma única linha, até 4000 caracteres, com aspas fechadas (comando_invalido). Se usa pipes, &&, variáveis, redirecionamentos ou comandos internos da shell, é envolvido automaticamente em /bin/sh -c "…" com o escape necessário.
• Horário: uma expressão OnCalendar (daily, *-*-* 02:00:00, Mon..Fri *-*-* 10:00, *-*-* *:0/5:00 Europe/Madrid). Atalhos: 5 ou */5 significam a cada 5 minutos, e 1 a cada minuto.
• O erro de validação diz que campo falhou em data.fields.

Criação

1. Guardam-se cópias da unidade e do timer se já existiam.
2. Escreve-se /etc/systemd/system/<nombre>.service (Type=oneshot, saída para o journal com o nome da tarefa) e /etc/systemd/system/<nombre>.timer (OnCalendar, Persistent=true).
3. daemon-reload, arranca-se o timer e ativa-se no arranque. Se um passo falhar, apaga-se o novo e restauram-se as cópias.
4. Com start=true o comando corre também uma vez nesse momento (se essa execução falhar, a tarefa fica criada na mesma).

Editar, controlar e apagar

• Editar lê o comando e o horário atuais, apaga a tarefa e volta a criá-la com o novo. A tarefa editada fica ativada.
• `start` corre o comando agora; `stop` interrompe essa execução (não para o timer).
• `enable` e `disable` mudam se o timer arranca com o sistema. disable não para um timer que já está ativo: continua a disparar até ao próximo reinício do VPS.
• Apagar para e desativa o timer, remove os dois arquivos e recarrega o systemd. Não há nomes protegidos.

O que muda realmente?

• /etc/systemd/system/<nombre>.service e /etc/systemd/system/<nombre>.timer, com permissões 644.
• O comando corre como root, e a sua saída fica no journal identificada com o nome da tarefa.
• Uma entrada no registro de atividade do VPS por cada criação, edição, ação e exclusão.

# <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

• Criar, editar e controlar devolvem timer_status, is_enabled e, salvo ao criar, next_run.
• ver_tarea_vps mostra o conteúdo do serviço e do timer, o estado, e a próxima e a última execução.
• ver_logs_tarea_vps com log_type: "service" mostra a saída do comando; com "timer", a do timer.

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

Erros e resolução

Criar com o mesmo nome substitui a tarefa; tentar de novo após um corte é seguro com a mesma idempotency_key. controlar_tarea_vps com start volta a correr o comando de cada vez.

Relação com MCP

Sim, nos perfis /mcp e /mcp/vps.

Referência em /mcp/docs e exemplos em /mcp/servicios.

Funcionalidades relacionadas

• Serviços systemd
• Cópias de segurança
• Monitoramento
• Servidores VPS