Do cron aos temporizadores do systemd

Migrar um trabalho do cron para um temporizador do systemd é reescrever uma linha de cron de cinco campos como uma unidade .timer cuja expressão OnCalendar diz quando a unidade .service correspondente deve executar — e depois provar que os dois agendamentos concordam antes de apagar a linha do cron. A conversão parece mecânica: minutos e horas correspondem diretamente, meses também, e a maioria dos agendamentos simples se traduz sem problemas. O problema é que os dois agendadores não entendem a mesma coisa por um agendamento de aparência idêntica, e os pontos em que divergem são justamente os que um olhar não detecta: um dia do mês combinado com um dia da semana, uma execução dentro do intervalo perdido na virada do horário de verão, um trabalho mensal no dia 31. Você pode converter e provar os dois lados no Conversor de cron para temporizador do systemd, que calcula as próximas 100 execuções de cada um e marca onde divergem — tudo no seu navegador.

Por que as equipes abandonam o cron — e por que o cron ainda serve para trabalhos simples

O cron é o agendador mais antigo do Unix, e seus limites são as razões pelas quais as equipes o abandonam. Um trabalho do cron não pode esperar que outro serviço esteja pronto: se o trabalho precisa do banco de dados no ar, ele executa mesmo assim e falha, porque o cron não tem ordenação de dependências. Sua saída vai para o e-mail local ou para lugar nenhum, então um trabalho que falha em silêncio continua falhando em silêncio — não há journal para consultar nem estado para verificar. Seu calendário tem cinco campos, então não há como dizer "a primeira segunda-feira do mês" ou "o último dia de fevereiro", e uma máquina desligada ou adormecida no minuto programado simplesmente perde aquela execução. Um temporizador do systemd corrige cada um desses pontos: dependências com After= e Requires=, cada disparo registrado no journal como qualquer outra unidade, uma recuperação com Persistent= para as execuções perdidas e uma expressão OnCalendar com nomes de dias da semana, intervalos de datas e sintaxe de último dia do mês.

Nada disso significa que o cron esteja obsoleto, e migrar um trabalho que funciona só porque os temporizadores são mais novos é um erro. O cron continua sendo a ferramenta certa para um trabalho simples por usuário, para um agendamento que não muda há uma década e para qualquer sistema sem systemd — contêineres, imagens mínimas, hosts BSD e macOS. O teste não é qual agendador é mais novo, e sim do que o trabalho precisa: se precisa de ordenação, registro, recuperação após inatividade ou de um calendário que o cron não consegue expressar, migre-o. Se é um agendamento de uma linha que nunca falhou e que ninguém nunca precisou depurar, deixe-o em paz. Uma migração que não compra nada é risco sem retorno, e este artigo trata das migrações que compram algo — feitas de um jeito que não pode mudar em silêncio quando o trabalho executa.

A armadilha DOM+DOW: o único erro de migração que duplica execuções em silêncio

A linha mais perigosa de uma migração de cron é a que restringe ao mesmo tempo o dia do mês e o dia da semana, e o exemplo clássico é 0 0 15 * 5. A maioria lê como "meia-noite da sexta-feira 15". Não é isso que significa. A página do manual crontab(5) enuncia a regra sem rodeios: se os dois campos de dia estiverem restritos — nenhum contém "*" — o comando executa quando qualquer um dos campos corresponde. Assim, 0 0 15 * 5 dispara à meia-noite do dia 15 de cada mês e em todas as sextas-feiras, cerca de cinco vezes por mês em vez de uma, e vem fazendo isso desde que a linha existe. Quem o converte em uma única linha OnCalendar acabou de mudar o agendamento sem saber.

O OnCalendar significa o contrário. A página do manual systemd.time(7) dá o exemplo Thu,Fri 2012-*-1,5 e diz que ele se refere ao primeiro ou quinto dia do mês, "mas somente se esse dia for uma quinta ou sexta-feira" — a data e o dia da semana precisam corresponder os dois. Portanto, a conversão ingênua Fri *-*-15 00:00 só dispara quando o dia 15 realmente cai numa sexta-feira, poucas vezes por ano, e as execuções das sextas e a maioria das do dia 15 desaparecem em silêncio. A conversão correta são duas linhas OnCalendar em uma única unidade .timer — *-*-15 00:00 e Fri *-*-* 00:00 — porque a página do manual systemd.timer(5) permite especificar OnCalendar mais de uma vez, e a unidade dispara quando qualquer uma de suas expressões vence. Essa união é o sentido do conversor: ele emite as duas linhas e marca a entrada como união, em vez de emitir uma única linha que muda o agendamento em silêncio.

Horário de verão e fim de mês: onde os dois agendadores realmente divergem

O horário de verão é o ponto em que os dois agendadores deixam de concordar mesmo em princípio, e as páginas do manual são honestas sobre essa assimetria. Para o cron, a crontab(5) enuncia a regra explicitamente: horários inexistentes, como as "horas perdidas" na virada da primavera, nunca correspondem, então um trabalho agendado para as 02:30 naquele dia simplesmente não executa — e horários que ocorrem duas vezes, na virada do outono, fazem os trabalhos correspondentes executarem duas vezes. Para os temporizadores, as páginas do manual do systemd não enunciam nenhuma regra equivalente: systemd.time(7) e systemd.timer(5) descrevem a sintaxe do calendário em detalhes, mas nenhuma das duas diz o que um disparo OnCalendar faz dentro da hora perdida. Esse silêncio é um fato, não uma omissão a ser preenchida por palpite, e este artigo não inventará uma regra que as páginas do manual não enunciam.

O fim do mês é a mesma história em miniatura. Uma linha de cron para o dia 31 simplesmente pula cada mês que não tem 31 dias, e o OnCalendar faz o mesmo por padrão — mas o OnCalendar também oferece sintaxe que o cron não consegue expressar de forma alguma, como a forma de último dia com "~": *-02~01 significa o último dia de fevereiro, e Mon *-05~07/1 significa a última segunda-feira de maio. A consequência prática é simples: mantenha os trabalhos sensíveis a horário fora das 02:00–03:00 se puder, e se não puder, gere a tabela das próximas 100 execuções cruzando uma virada de horário e um fim de mês, e leia-a em vez de adivinhar. Onde as páginas do manual calam, a tabela é a única resposta honesta — execute-a, não presuma. O mesmo vale para o AccuracySec: os temporizadores não disparam necessariamente no segundo exato configurado, então um agendamento que depende de segundos exatos precisa de outro desenho, não de uma expressão mais apertada.

O fluxo de prova: compare as próximas 100 execuções antes de mudar

O fluxo de prova é curto, e pulá-lo é como um erro de migração chega à produção. Converta a linha do cron e depois calcule as próximas 100 execuções dos dois lados a partir da mesma hora inicial e no mesmo fuso horário, lado a lado, e leia o veredito sobre as 100 completas — não sobre as primeiras. Uma divergência mensal pode não aparecer nas primeiras dez linhas, e uma divergência de horário de verão não aparecerá de forma alguma a menos que a janela cruze uma mudança de relógio, e é por isso que a tabela vai até 100 execuções e não 10. O conversor calcula as duas tabelas no seu navegador e destaca as primeiras linhas em que divergem; o systemd-analyze calendar valida uma expressão OnCalendar por vez, o que serve para verificar a metade do temporizador, mas não pode comparar as duas metades por você.

A segunda metade do fluxo é uma pista para a próxima pessoa. Mantenha a linha original do cron como comentário no arquivo .timer ou .service, junto às linhas OnCalendar que a substituíram, para que quem ler a unidade possa ver o que ela substituiu e por que há duas linhas em vez de uma. Uma conversão sem a sua linha de origem é um agendamento que ninguém pode auditar: seis meses depois, ninguém lembrará se a segunda linha OnCalendar foi deliberada ou um resto, e a tentação será "limpá-la" — que é como as execuções das sextas-feiras desaparecem pela segunda vez. A linha do cron comentada custa uma linha e responde à pergunta antes que ela seja feita.

O caminho seguro de migração: drop-ins, Persistent e a lacuna do @reboot

Nunca edite à mão um arquivo de unidade empacotado em /usr/lib/systemd/system: a próxima atualização do pacote o sobrescreve, e a migração desaparece em silêncio junto com o endurecimento. O caminho suportado é um drop-in — execute systemctl edit myjob.timer e suas alterações caem em /etc/systemd/system/myjob.timer.d/override.conf, onde têm precedência sobre o arquivo distribuído, sobrevivem a atualizações e podem ser removidas apagando um arquivo. Depois recarregue, habilite o temporizador e confirme que ele está realmente armado com systemctl list-timers, que mostra a próxima hora de disparo — o único número que diz se a conversão produziu o agendamento que você queria.

Dois ajustes merecem uma decisão deliberada em vez de um valor padrão. Persistent=true é a escolha certa para laptops e desktops que dormem: se a máquina estava desligada quando um disparo vencia, o serviço executa uma vez na próxima oportunidade em vez de aquela execução nunca acontecer em silêncio — note que é uma única recuperação, não uma repetição de todas as execuções perdidas, e que só se aplica a temporizadores OnCalendar. E o @reboot não tem um equivalente real em temporizadores: o OnBootSec=, que dispara um tempo fixo após a inicialização, é o análogo mais próximo, e não é idêntico — ele é relativo à inicialização e não "executar uma vez na partida", e em contêineres corresponde ao OnStartupSec=. Se o trabalho deve executar exatamente uma vez por inicialização, o OnBootSec= é a resposta, mas documente a diferença na unidade; não finja que a conversão é exata quando a página do manual diz o contrário.

O hábito de auditar primeiro: converta, prove, execute em paralelo e depois mude

A mudança mais segura é entediante de propósito. Converta, prove com a tabela das próximas 100 execuções e depois — quando o trabalho for idempotente — execute a linha do cron e o temporizador em paralelo por uma semana e compare os resultados: os registros, as saídas, os efeitos colaterais. Uma semana cobre um ciclo semanal completo e normalmente uma virada de horário ou um fim de mês se houver um por perto, e qualquer disparo que a tabela de prova previu aparecerá no journal ao lado da execução do cron que ele duplica. Somente quando os dois concordarem por uma semana completa você apaga a linha do cron, e mantém a cópia comentada na unidade como a pista da seção anterior.

Quando o trabalho não é idempotente — ele envia e-mail, cobra um cliente ou altera um banco de dados — não execute os dois, porque a duplicação é o erro que você está tentando evitar. Prove com mais rigor: execute a tabela de 100 execuções cruzando uma virada de horário e um fim de mês, revise à mão as primeiras linhas que divergem e mude em um único passo, com a linha antiga comentada na unidade. Depois audite a unidade finalizada como auditaria qualquer outra: pontue-a com o Auditor de unidades do systemd e leia o artigo complementar Como endurecer os serviços do systemd, porque um temporizador migrado herda as mesmas questões de sandbox que qualquer outra unidade. Mantenha o temporizador, o serviço e a prova em controle de versão — um agendamento que vive só em uma máquina está a uma reconstrução de ser esquecido.

Fontes

Perguntas frequentes

O OnCalendar é só o cron com outra sintaxe?

Não — a sintaxe se sobrepõe, mas a semântica difere nos pontos que importam. O cron aplica OU entre o dia do mês e o dia da semana quando ambos estão restritos; o OnCalendar aplica E. O OnCalendar admite segundos, intervalos de datas como 01..07, intervalos de dias da semana, fusos horários e sintaxe de último dia do mês com "~" — nada disso uma linha de cron de cinco campos consegue expressar. Ele também admite várias linhas OnCalendar em uma unidade e temporizadores monotônicos como o OnBootSec=. A maioria dos agendamentos simples se traduz sem problemas; os casos de armadilha são as combinações DOM+DOW, os segundos, o @reboot e os intervalos de datas, e esses são justamente os casos que o conversor sinaliza em vez de adivinhar.

O que acontece com um disparo de temporizador dentro do intervalo perdido na virada da primavera?

As páginas do manual não dizem. A crontab(5) é explícita para o cron: um trabalho agendado na hora perdida nunca executa, e um trabalho agendado na hora repetida executa duas vezes. O systemd.time(7) e o systemd.timer(5) não enunciam nenhuma regra equivalente para o OnCalendar, então não presuma que um temporizador se comporta como o cron às 02:30 do dia da virada da primavera. A verificação honesta é a tabela de prova: gere as próximas 100 execuções cruzando a virada de horário no conversor e leia o que realmente acontece. Se o trabalho é sensível a horário, a escolha mais segura é agendá-lo fora das 02:00–03:00 por completo.

Posso executar o cron e o temporizador lado a lado durante a migração?

Sim, se o trabalho for idempotente — seguro executá-lo duas vezes com o mesmo resultado. Execute os dois por uma semana, compare os registros e as saídas, e apague a linha do cron somente quando os dois concordarem. Se o trabalho não for idempotente — ele envia e-mail, cobra um pagamento ou altera estado — não execute os dois, porque a execução duplicada é em si mesma a falha. Nesse caso, prove o agendamento com a tabela de 100 execuções, mude em um único passo e mantenha a linha antiga do cron comentada na unidade para que a conversão continue auditável.