从 Cron 迁移到 systemd 定时器
最后更新:
所谓把一个任务从 cron 迁移到 systemd 定时器,就是把一行五段式的 cron 表达式改写成一个 .timer 单元,由它的 OnCalendar 表达式决定何时运行对应的 .service 单元——然后在删除 cron 那行之前,证明两边的计划是一致的。转换看起来是机械的:分钟和小时直接对应,月份直接对应,大多数简单计划都能干净地翻译过来。问题在于,两个调度器对“看起来一样的计划”理解并不相同,而它们的分歧点正是一眼看不出来的地方:同时限定了“日”和“星期”、触发时间落在夏令时跳过的那一小时、定在 31 号的月度任务。你可以在Cron ⇄ systemd 定时器转换器里转换并证明两边:它会算出各自未来 100 次的触发时间,标出不一致的地方——全程在浏览器本地完成。
团队为什么离开 cron——以及 cron 对简单任务仍然够用
Cron 是 Unix 上最古老的调度器,团队离开它正是因为它的局限。Cron 任务无法等待另一个服务就绪:如果任务需要数据库先起来,它照样会跑、然后失败,因为 cron 没有依赖顺序。它的输出发往本地邮件或者干脆丢掉,所以一个悄悄失败的任务会一直悄悄失败——没有 journal 可以查,也没有状态可以看。它的日历只有五个字段,无法表达“每月的第一个星期一”或者“二月的最后一天”,而机器在计划的那一分钟正好关机或休眠,那次运行就直接错过了。systemd 定时器逐个修掉了这些问题:用 After= 和 Requires= 做依赖、每次触发都像其他单元一样记进 journal、用 Persistent= 补跑错过的运行、OnCalendar 表达式支持星期名、日期范围和月末语法。
但这并不意味着 cron 过时了,为了“定时器更新”就去迁移一个跑得好好的任务是错误的。Cron 对简单的每用户任务仍然是对的工具,对一张十年没变过的计划表仍然是对的工具,对任何没有 systemd 的系统——容器、最小镜像、BSD 和 macOS 主机——仍然是对的工具。判断标准不是哪个调度器更新,而是任务需要什么:如果任务需要顺序、日志、停机后的补跑,或者 cron 表达不了的日历,就迁移它。如果它是一行从没出过问题、也没人需要调试过的计划,就别动它。买不到任何东西的迁移就是只有风险没有回报,而本文讲的是那些确实能买到东西的迁移——用一种不会悄悄改变任务运行时间的方式来做。
DOM+DOW 陷阱:那个会让触发次数悄悄翻倍的迁移 bug
Cron 迁移里最危险的一行,就是同时限定了“日”和“星期”的那一行,经典例子是 0 0 15 * 5。多数人会把它读成“每月 15 号那个星期五的午夜”。它不是这个意思。crontab(5) 手册页把规则写得很直白:如果两个“日”字段都被限定了——也就是都不含“*”——那么只要任意一个字段匹配,命令就会运行。所以 0 0 15 * 5 会在每月 15 号午夜触发,并且在每个星期五触发,一个月大约触发五次而不是一次,而且这行存在多久,它就这么跑了多久。任何把它转成单行 OnCalendar 的人,都在不知情的情况下改了计划。
OnCalendar 的意思恰恰相反。systemd.time(7) 手册页给的例子是 Thu,Fri 2012-*-1,5,并说它指的是每月 1 号或 5 号,“但前提是那天是星期四或星期五”——日期和星期必须同时匹配。所以天真的转换 Fri *-*-15 00:00 只在 15 号正好是星期五时才触发,一年只有几次,星期五的运行和大多数 15 号的运行就悄悄消失了。正确的转换是在一个 .timer 单元里写两行 OnCalendar——*-*-15 00:00 和 Fri *-*-* 00:00——因为 systemd.timer(5) 手册页允许 OnCalendar 写多次,任意一个表达式到点单元就会触发。这正是转换器的意义所在:它会同时输出这两行,并把这条记录标为“并集”,而不是输出一行悄悄改掉计划的表达式。
夏令时与月末:两个调度器真正不一致的地方
夏令时是两个调度器连原则上都不再一致的地方,而手册页对这种不对称是诚实的。对于 cron,crontab(5) 把规则写得很明确:不存在的时间,比如夏令时向前拨快时“消失的那几个小时”,永远不会匹配,所以定在那天 02:30 的任务那天根本不运行——而出现两次的时间(向后拨慢时),匹配的任务会运行两次。对于定时器,systemd 的手册页没有对应的规则:systemd.time(7) 和 systemd.timer(5) 把日历语法讲得很细,但哪一页都没说 OnCalendar 的触发落在消失的那一小时里会怎样。这种沉默是一个事实,不是一个可以靠猜测填补的疏漏,本文也不会编造一条手册页没有的规则。
月末是同一个故事的缩小版。定在 31 号的 cron 行会在没有 31 号的月份直接跳过,OnCalendar 默认也是这样——但 OnCalendar 还提供了 cron 完全表达不了的语法,比如“~”月末形式:*-02~01 是二月的最后一天,Mon *-05~07/1 是五月的最后一个星期一。实际做法很简单:如果可以,把对时间敏感的任务安排在 02:00–03:00 之外;如果不行,就生成一张跨越夏令时边界和月末的未来 100 次触发表,读表而不是猜测。手册页沉默的地方,表就是唯一诚实的答案——跑表,不要假设。AccuracySec 也一样:定时器不一定在配置的那一秒精确触发,所以依赖精确到秒的计划需要换一种设计,而不是把表达式写得更紧。
证明工作流:切换之前,先对比未来 100 次触发
证明工作流很短,而跳过它正是迁移 bug 进入生产环境的方式。转换 cron 行之后,从同一个起始时间、同一个时区,分别算出两边未来 100 次的触发时间,并排对比,读完整整 100 次的结论——而不是只看前几行。月度分歧可能在前十行里根本不出现,而夏令时分歧除非窗口跨过拨表那一天,否则根本不会出现,这就是表要算到 100 次而不是 10 次的原因。转换器在浏览器里算出两张表,并高亮第一处不一致的行;systemd-analyze calendar一次只能校验一个 OnCalendar 表达式,适合检查定时器那一半,但它帮不了你对比两边。
工作流的另一半,是给下一个人留一条线索。把原始的 cron 行以注释形式留在 .timer 或 .service 文件里,放在取代它的 OnCalendar 行旁边,这样任何读这个单元的人都能看到它取代了什么、为什么这里有两行而不是一行。没有来源行的转换,是一个没人能审计的计划:六个月后,没人会记得第二行 OnCalendar 是特意加的还是遗留的,顺手“清理掉”的诱惑一直都在——而这正是星期五的运行第二次消失的方式。注释掉的 cron 行只要一行,就能在问题被问出来之前回答它。
安全的迁移路径:drop-in、Persistent,以及 @reboot 的缺口
永远不要手工编辑 /usr/lib/systemd/system 里的打包单元文件:下一次软件包更新会把它覆盖掉,迁移连同加固一起悄无声息地消失。支持的做法是 drop-in 覆盖——运行 systemctl edit myjob.timer,你的改动就落在 /etc/systemd/system/myjob.timer.d/override.conf 里,它优先于出厂文件、能挺过升级、删一个文件就能撤掉。然后重新加载、启用定时器,再用 systemctl list-timers 确认它真的已布防,这条命令会显示下一次触发时间——这是唯一能告诉你转换结果是不是你想要的计划的数字。
有两项设置值得特意决定,而不是随手用默认值。对经常休眠的笔记本和台式机,Persistent=true 是正确的选择:如果机器在某次触发应到时正好关机,服务会在下一个机会补跑一次,而不是那次运行悄悄地永远不发生——注意它是一次补跑,不是把所有错过的运行都重放一遍,而且它只对 OnCalendar 定时器有效。而 @reboot 没有真正的定时器等价物:OnBootSec= 是最接近的类比——在启动后固定时间触发——但它并不相同:它是相对于启动时刻,而不是“每次启动运行一次”,而且在容器里它会被映射为 OnStartupSec=。如果任务必须每次启动恰好运行一次,OnBootSec= 就是答案,但请在单元里写明这个差别;手册页都说了不相同,就不要假装这次转换是精确的。
先审计的习惯:转换、证明、并行运行,再切换
最安全的切换是故意做得无聊一点。转换、用未来 100 次触发表证明,然后——在任务幂等的前提下——让 cron 行和定时器并行跑一个星期,对比结果:日志、输出、副作用。一个星期覆盖一个完整的周循环,通常还会碰上临近的夏令时边界或月末,而证明表预测过的每一次触发,都会在 journal 里出现在它复制的那次 cron 运行旁边。只有当两边完整地一致了一个星期,才删除 cron 那行,并且把注释掉的副本留在单元里,作为上一节说的线索。
如果任务不是幂等的——它发邮件、扣款、改数据库——就不要并行跑,因为重复运行本身就是你要避免的 bug。改成证明得更彻底:让 100 次触发表跨过夏令时边界和月末,手工核对第一处不一致的行,然后一步切换,把旧的那行以注释形式留在单元里。再用审计任何其他单元的方式审计完成迁移的单元:用systemd 单元审计工具打分,读配套文章如何加固 systemd 服务,因为迁移过来的定时器和任何其他单元面临同样的沙箱问题。把定时器、服务和证明放进版本控制——一个只存在于某一台机器上的计划,离一次重建就被遗忘只有一步之遥。