Timers do systemd como substituto do cron: OnCalendar, Persistent= e RandomizedDelaySec

Objetivo

Agendar uma tarefa recorrente com um timer do systemd em vez de uma entrada do crontab, de modo que uma execução perdida (porque o host estava desligado) possa ser recuperada e a carga possa ser distribuída entre muitos hosts.

Pré-requisitos

Acesso root em uma distribuição baseada em systemd; um comando a executar, encapsulado em um script idempotente.

Passos

1. Escreva a tarefa como um serviço oneshot, em /etc/systemd/system/backup.service:

   [Unit]
   Description=Nightly backup
   
   [Service]
   Type=oneshot
   ExecStart=/usr/local/bin/backup.sh
   

2. Escreva o timer correspondente, /etc/systemd/system/backup.timer:

   [Unit]
   Description=Run backup.service nightly
   
   [Timer]
   OnCalendar=*-*-* 03:00:00
   Persistent=true
   RandomizedDelaySec=15min
   
   [Install]
   WantedBy=timers.target
   

   OnCalendar= usa a sintaxe de eventos de calendário descrita em systemd.time(7) (nomes de dias da semana, intervalos e curingas * nos campos de data). Persistent=true faz o systemd executar o serviço uma vez, no próximo boot ou na próxima ativação do timer, caso a última execução agendada tenha sido perdida enquanto o sistema estava desligado. RandomizedDelaySec= soma ao horário de OnCalendar= um atraso aleatório, com distribuição uniforme, de até o valor indicado; isso é útil para evitar que muitos hosts acessem um recurso compartilhado no mesmo segundo.
3. Antes de ativar, valide e visualize a expressão: systemd-analyze calendar 'Mon..Fri *-*-* 03:00:00'. O comando mostra a forma normalizada e o próximo momento de disparo, sem alterar nenhuma unidade.
4. Recarregue os arquivos de unidade e depois ative o timer (não o serviço), para que ele sobreviva a reinicializações e comece a funcionar agora: systemctl daemon-reload && systemctl enable --now backup.timer. Execute a tarefa uma vez manualmente (systemctl start backup.service) para ver falhas imediatamente, em vez de só às 03:00.
5. Liste as execuções agendadas e as próximas: systemctl list-timers backup.timer (ou --all, para incluir também os inativos), que exibe as colunas NEXT e LEFT.

Resultado esperado

systemctl list-timers mostra backup.timer com um horário NEXT no futuro; journalctl -u backup.service mostra uma execução concluída nesse horário ou depois dele (considerando o atraso aleatório).

Limites e base de verificação

Baseado em systemd.timer(5), systemd.time(7) e systemd-analyze(1). Para desfazer: systemctl disable --now backup.timer, remova os dois arquivos de unidade e execute systemctl daemon-reload. Por padrão, a precisão do timer é de cerca de um minuto (AccuracySec=1min); por isso, não há garantia de precisão inferior a um minuto.