От cron к таймерам systemd
Последнее обновление:
Перенести задание из cron в таймер systemd — значит переписать пятиполевую строку cron в юнит .timer, чьё выражение OnCalendar говорит, когда должен запускаться соответствующий юнит .service, — а затем доказать, что оба расписания совпадают, прежде чем удалять строку cron. Преобразование выглядит механическим: минуты и часы отображаются напрямую, месяцы тоже, и большинство простых расписаний переводятся чисто. Подвох в том, что два планировщика понимают одинаково выглядящее расписание по-разному, а места, где они расходятся, — именно те, которые взгляд не замечает: день месяца в сочетании с днём недели, срабатывание внутри «пропавшего часа» весеннего перехода, ежемесячное задание на 31-е число. Обе стороны можно преобразовать и доказать в конвертере cron ⇄ таймер systemd, который вычисляет следующие 100 срабатываний каждой стороны и помечает, где они расходятся, — полностью в вашем браузере.
Почему команды уходят от cron — и почему cron по-прежнему годится для простых заданий
Cron — старейший планировщик в Unix, и его ограничения — это причины, по которым команды от него уходят. Задание cron не может дождаться готовности другого сервиса: если заданию нужна база данных, оно всё равно запустится и упадёт, потому что в cron нет порядка зависимостей. Его вывод уходит в локальную почту или в никуда, поэтому задание, которое молча падает, продолжает молча падать — нет журнала, который можно запросить, и нет состояния, которое можно проверить. Его календарь шириной в пять полей, поэтому нет способа сказать «первый понедельник месяца» или «последний день февраля», а машина, которая была выключена или спала в запланированную минуту, просто пропускает запуск. Таймер systemd исправляет каждый из этих пунктов: зависимости через After= и Requires=, каждое срабатывание записано в журнал, как у любого другого юнита, догоняющий запуск Persistent= для пропущенных срабатываний и выражение OnCalendar с именами дней недели, диапазонами дат и синтаксисом последнего дня месяца.
Ничего из этого не означает, что cron устарел, а переносить работающее задание только потому, что таймеры новее, — ошибка. Cron по-прежнему остаётся правильным инструментом для простого задания на пользователя, для расписания, которое не менялось десятилетие, и для любой системы без systemd — контейнеров, минимальных образов, хостов BSD и macOS. Проверка не в том, какой планировщик новее, а в том, что нужно заданию: если ему нужны порядок, журналирование, догон после простоя или календарь, который cron не может выразить, переносите его. Если это однострочное расписание, которое никогда не падало и которое никому не приходилось отлаживать, оставьте его в покое. Миграция, которая ничего не даёт, — это риск без отдачи, а эта статья — о миграциях, которые что-то дают, выполненных так, чтобы они не могли молча изменить время запуска задания.
Ловушка DOM+DOW: единственная ошибка миграции, которая молча удваивает срабатывания
Самая опасная строка в миграции cron — та, что ограничивает одновременно и день месяца, и день недели, а классический пример — 0 0 15 * 5. Большинство читает это как «полночь пятницы, 15-го числа». Это не то, что оно означает. Страница руководства crontab(5) формулирует правило прямо: если оба поля дня ограничены — ни одно не содержит «*» — команда выполняется, когда совпадает любое из полей. Значит, 0 0 15 * 5 срабатывает в полночь 15-го числа каждого месяца и каждую пятницу, примерно пять раз в месяц вместо одного, и делает это с тех пор, как существует эта строка. Тот, кто преобразует её в одну строку OnCalendar, только что изменил расписание, сам того не зная.
OnCalendar означает противоположное. Страница руководства systemd.time(7) приводит пример Thu,Fri 2012-*-1,5 и говорит, что он относится к первому или пятому дню месяца, «но только если этот день — четверг или пятница», — дата и день недели должны совпадать оба. Значит, наивное преобразование Fri *-*-15 00:00 срабатывает только тогда, когда 15-е действительно выпадает на пятницу, несколько раз в год, а пятничные запуски и большинство запусков 15-го числа молча исчезают. Правильное преобразование — две строки OnCalendar в одном юните .timer — *-*-15 00:00 и Fri *-*-* 00:00, — потому что страница руководства systemd.timer(5) позволяет указывать OnCalendar более одного раза, а юнит срабатывает, когда истекает любое из его выражений. Это объединение — весь смысл конвертера: он выдаёт обе строки и помечает запись как объединение, вместо того чтобы выдать одну строку, которая молча меняет расписание.
Летнее время и конец месяца: где два планировщика действительно расходятся
Переход на летнее время — это точка, где два планировщика перестают совпадать даже в принципе, и страницы руководства честны насчёт этой асимметрии. Для cron crontab(5) формулирует правило явно: несуществующие времена, такие как «пропавшие часы» весеннего перехода, никогда не совпадают, поэтому задание, запланированное на 02:30 в этот день, просто не выполняется, — а времена, которые случаются дважды, при осеннем переходе, заставляют совпадающие задания выполняться дважды. Для таймеров страницы руководства systemd не формулируют эквивалентного правила: systemd.time(7) и systemd.timer(5) подробно описывают синтаксис календаря, но ни одна из них не говорит, что делает срабатывание OnCalendar внутри пропавшего часа. Это молчание — факт, а не пробел, который следует заполнить догадкой, и эта статья не будет выдумывать правило, которого нет в руководствах.
Конец месяца — та же история в миниатюре. Строка cron на 31-е просто пропускает каждый месяц, в котором нет 31-го числа, и OnCalendar по умолчанию делает то же самое, — но OnCalendar предлагает и синтаксис, который cron вообще не может выразить, например форму последнего дня с «~»: *-02~01 означает последний день февраля, а Mon *-05~07/1 — последний понедельник мая. Практический вывод прост: держите чувствительные ко времени задания вне 02:00–03:00, если можете, а если не можете, сгенерируйте таблицу следующих 100 срабатываний через границу перехода на летнее время и конец месяца и прочитайте её вместо догадок. Там, где руководства молчат, таблица — единственный честный ответ: запустите её, не предполагайте. То же касается AccuracySec: таймеры не обязательно срабатывают ровно в настроенную секунду, поэтому расписание, зависящее от точных секунд, требует другого дизайна, а не более жёсткого выражения.
Рабочий процесс доказательства: сравните следующие 100 срабатываний перед переключением
Рабочий процесс доказательства короток, и его пропуск — это путь, которым ошибка миграции попадает в продакшн. Преобразуйте строку 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 и таймер параллельно на неделю и сравните результаты: журналы, выходные данные, побочные эффекты. Неделя покрывает полный недельный цикл и обычно границу летнего времени или конец месяца, если они рядом, а каждое срабатывание, предсказанное таблицей доказательства, появится в журнале рядом с запуском cron, который оно дублирует. Только когда обе стороны полностью совпадают целую неделю, удаляйте строку cron, а закомментированную копию сохраняйте в юните как подсказку из предыдущего раздела.
Где задание не идемпотентно — оно отправляет почту, списывает деньги с клиента, изменяет базу данных — не запускайте оба, потому что дублирование и есть та ошибка, которую вы пытаетесь избежать. Докажите строже: прогоните таблицу из 100 срабатываний через границу летнего времени и конец месяца, проверьте вручную первые различающиеся строки и переключитесь за один шаг, оставив старую строку закомментированной в юните. Затем проверьте готовый юнит так же, как любой другой: оцените его с помощью аудитора юнитов systemd и прочитайте сопутствующую статью Как усилить защиту сервисов systemd, потому что перенесённый таймер наследует те же вопросы песочницы, что и любой другой юнит. Держите таймер, сервис и доказательство в системе контроля версий — расписание, которое живёт только на одной машине, отделено от забвения одной пересборкой.