Von Cron zu systemd-Timern

Einen Job von Cron zu einem systemd-Timer zu migrieren, heißt, eine fünfteilige Cron-Zeile als .timer-Unit umzuschreiben, deren OnCalendar-Ausdruck sagt, wann eine passende .service-Unit laufen soll — und dann zu beweisen, dass beide Zeitpläne übereinstimmen, bevor die Cron-Zeile gelöscht wird. Die Konvertierung wirkt mechanisch: Minuten und Stunden bilden sich direkt ab, Monate auch, und die meisten einfachen Zeitpläne lassen sich sauber übersetzen. Der Haken ist, dass die beiden Scheduler unter einem gleich aussehenden Zeitplan nicht dasselbe verstehen, und die Stellen, an denen sie sich unterscheiden, sind genau die, die ein Blick nicht erkennt: ein Monatstag kombiniert mit einem Wochentag, eine Auslösung in der Lücke der Sommerzeitumstellung, ein Monatsjob am 31. Beide Seiten lassen sich im Cron-zu-systemd-Timer-Konverter konvertieren und beweisen, der die nächsten 100 Auslösungen jeder Seite berechnet und markiert, wo sie sich unterscheiden — vollständig in Ihrem Browser.

Warum Teams von Cron weggehen — und warum Cron für einfache Jobs weiterhin reicht

Cron ist der älteste Scheduler auf Unix, und seine Grenzen sind die Gründe, aus denen Teams ihn verlassen. Ein Cron-Job kann nicht darauf warten, dass ein anderer Dienst bereit ist: Wenn der Job die Datenbank braucht, läuft er trotzdem und scheitert, denn Cron kennt keine Abhängigkeitsreihenfolge. Seine Ausgabe geht an die lokale Mail oder nirgendwohin, also scheitert ein Job, der leise scheitert, weiter leise — es gibt kein Journal zum Abfragen und keinen Status zum Prüfen. Sein Kalender ist fünf Felder breit, also gibt es keine Möglichkeit, „der erste Montag im Monat" oder „der letzte Tag im Februar" zu sagen, und eine Maschine, die zur geplanten Minute aus oder im Schlaf war, verpasst den Lauf einfach. Ein systemd-Timer behebt jeden dieser Punkte: Abhängigkeiten mit After= und Requires=, jede Auslösung im Journal protokolliert wie bei jeder anderen Unit, ein Persistent=-Nachholen für verpasste Läufe und ein OnCalendar-Ausdruck mit Wochentagsnamen, Datumsbereichen und Letzter-Tag-des-Monats-Syntax.

Nichts davon bedeutet, dass Cron veraltet ist, und einen funktionierenden Job nur deshalb zu migrieren, weil Timer neuer sind, ist ein Fehler. Cron ist weiterhin das richtige Werkzeug für einen einfachen Job pro Benutzer, für einen Zeitplan, der seit einem Jahrzehnt unverändert läuft, und für jedes System ohne systemd — Container, minimale Images, BSD- und macOS-Hosts. Der Test ist nicht, welcher Scheduler neuer ist, sondern was der Job braucht: Wenn der Job Reihenfolge, Protokollierung, Nachholen nach Ausfallzeiten oder einen Kalender braucht, den Cron nicht ausdrücken kann, migrieren Sie ihn. Wenn es ein einzeiliger Zeitplan ist, der nie gescheitert ist und den niemand je debuggen musste, lassen Sie ihn in Ruhe. Eine Migration, die nichts einbringt, ist Risiko ohne Gegenwert, und in diesem Artikel geht es um die Migrationen, die etwas einbringen — durchgeführt so, dass sie nicht still verändern können, wann der Job läuft.

Die DOM+DOW-Falle: der eine Migrationsfehler, der Auslösungen still verdoppelt

Die gefährlichste Zeile in einer Cron-Migration ist eine, die sowohl den Tag des Monats als auch den Wochentag einschränkt, und das klassische Beispiel ist 0 0 15 * 5. Die meisten lesen es als „Mitternacht am Freitag, den 15.". Das bedeutet es nicht. Die Handbuchseite crontab(5) formuliert die Regel unmissverständlich: Wenn beide Tagesfelder eingeschränkt sind — keines enthält „*" — läuft der Befehl, wenn eines der beiden Felder passt. 0 0 15 * 5 löst also um Mitternacht am 15. jedes Monats und an jedem Freitag aus, etwa fünfmal im Monat statt einmal, und tut das, seit es die Zeile gibt. Wer sie in eine einzige OnCalendar-Zeile konvertiert, hat gerade den Zeitplan geändert, ohne es zu wissen.

OnCalendar bedeutet das Gegenteil. Die Handbuchseite systemd.time(7) gibt das Beispiel Thu,Fri 2012-*-1,5 und sagt, es beziehe sich auf den ersten oder fünften Tag des Monats, „aber nur, wenn dieser Tag ein Donnerstag oder Freitag ist" — Datum und Wochentag müssen beide passen. Die naive Konvertierung Fri *-*-15 00:00 löst also nur aus, wenn der 15. tatsächlich ein Freitag ist, wenige Male im Jahr, und die Freitagsläufe und die meisten Läufe am 15. verschwinden leise. Die korrekte Konvertierung sind zwei OnCalendar-Zeilen in einer .timer-Unit — *-*-15 00:00 und Fri *-*-* 00:00 — denn die Handbuchseite systemd.timer(5) erlaubt es, OnCalendar mehrfach anzugeben, und die Unit löst aus, sobald einer ihrer Ausdrücke eintritt. Diese Vereinigung ist der ganze Sinn des Konverters: Er gibt beide Zeilen aus und kennzeichnet den Eintrag als Vereinigung, statt eine Zeile auszugeben, die den Zeitplan still ändert.

Sommerzeit und Monatsende: wo die beiden Scheduler wirklich auseinandergehen

Die Sommerzeit ist der Punkt, an dem die beiden Scheduler nicht einmal mehr im Prinzip übereinstimmen, und die Handbuchseiten sind ehrlich, was diese Asymmetrie angeht. Für Cron formuliert crontab(5) die Regel ausdrücklich: Nicht existierende Zeiten wie die „fehlenden Stunden" bei der Umstellung im Frühjahr passen nie, also läuft ein Job, der an diesem Tag für 02:30 geplant ist, einfach nicht — und Zeiten, die zweimal vorkommen, bei der Umstellung im Herbst, lassen passende Jobs zweimal laufen. Für Timer formulieren die systemd-Handbuchseiten keine äquivalente Regel: systemd.time(7) und systemd.timer(5) beschreiben die Kalendersyntax im Detail, aber keine der beiden Seiten sagt, was eine OnCalendar-Auslösung innerhalb der fehlenden Stunde tut. Dieses Schweigen ist eine Tatsache, keine Lücke, die man durch Raten füllen dürfte, und dieser Artikel wird keine Regel erfinden, die die Handbuchseiten nicht enthalten.

Das Monatsende ist dieselbe Geschichte im Kleinen. Eine Cron-Zeile für den 31. überspringt einfach jeden Monat ohne 31 Tage, und OnCalendar tut standardmäßig dasselbe — aber OnCalendar bietet auch Syntax, die Cron überhaupt nicht ausdrücken kann, etwa die „~"-Form für den letzten Tag: *-02~01 bedeutet den letzten Tag im Februar, und Mon *-05~07/1 bedeutet den letzten Montag im Mai. Die praktische Konsequenz ist einfach: Halten Sie zeitkritische Jobs wenn möglich aus 02:00–03:00 heraus, und wenn das nicht geht, erzeugen Sie die Tabelle der nächsten 100 Auslösungen über eine Sommerzeitgrenze und ein Monatsende hinweg und lesen Sie sie, statt zu raten. Wo die Handbuchseiten schweigen, ist die Tabelle die einzige ehrliche Antwort — führen Sie sie aus, nehmen Sie nichts an. Dasselbe gilt für AccuracySec: Timer lösen nicht unbedingt in der genau konfigurierten Sekunde aus, also braucht ein Zeitplan, der von exakten Sekunden abhängt, ein anderes Design, keinen engeren Ausdruck.

Der Beweis-Workflow: Die nächsten 100 Auslösungen vergleichen, bevor Sie umstellen

Der Beweis-Workflow ist kurz, und ihn zu überspringen, ist der Weg, auf dem ein Migrationsfehler in die Produktion gelangt. Konvertieren Sie die Cron-Zeile, berechnen Sie dann die nächsten 100 Auslösungen beider Seiten ab derselben Startzeit in derselben Zeitzone, nebeneinander, und lesen Sie das Urteil über alle 100 — nicht über die ersten paar. Eine monatliche Abweichung erscheint in den ersten zehn Zeilen vielleicht gar nicht, und eine Sommerzeitabweichung erscheint überhaupt nicht, es sei denn, das Fenster überquert eine Zeitumstellung, weshalb die Tabelle bis 100 Auslösungen läuft und nicht bis 10. Der Konverter berechnet beide Tabellen in Ihrem Browser und hebt die ersten Zeilen hervor, in denen sie sich unterscheiden; systemd-analyze calendar prüft jeweils einen OnCalendar-Ausdruck, was nützlich ist, um die Timer-Hälfte zu prüfen, aber es kann die beiden Hälften nicht für Sie vergleichen.

Die zweite Hälfte des Workflows ist ein Hinweis für die nächste Person. Bewahren Sie die ursprüngliche Cron-Zeile als Kommentar in der .timer- oder .service-Datei auf, neben den OnCalendar-Zeilen, die sie ersetzt haben, damit jeder, der die Unit liest, sehen kann, was sie ersetzt hat und warum es zwei Zeilen statt einer gibt. Eine Konvertierung ohne ihre Quellzeile ist ein Zeitplan, den niemand prüfen kann: Sechs Monate später wird sich niemand erinnern, ob die zweite OnCalendar-Zeile absichtlich oder ein Überbleibsel war, und die Versuchung wird groß sein, sie „aufzuräumen" — und so verschwinden die Freitagsläufe ein zweites Mal. Die auskommentierte Cron-Zeile kostet eine Zeile und beantwortet die Frage, bevor sie gestellt wird.

Der sichere Migrationspfad: Drop-ins, Persistent und die @reboot-Lücke

Bearbeiten Sie niemals eine paketierte Unit-Datei in /usr/lib/systemd/system von Hand: Das nächste Paket-Update überschreibt sie, und die Migration verschwindet leise mitsamt der Härtung. Der unterstützte Weg ist ein Drop-in-Override — führen Sie systemctl edit myjob.timer aus, und Ihre Änderungen landen in /etc/systemd/system/myjob.timer.d/override.conf, wo sie Vorrang vor der ausgelieferten Datei haben, Updates überleben und durch Löschen einer Datei entfernt werden können. Laden Sie dann neu, aktivieren Sie den Timer und bestätigen Sie mit systemctl list-timers, dass er wirklich scharf ist — der Befehl zeigt die nächste Auslösezeit, die einzige Zahl, die Ihnen sagt, ob die Konvertierung den Zeitplan erzeugt hat, den Sie meinten.

Zwei Einstellungen verdienen eine bewusste Entscheidung statt eines Standardwerts. Persistent=true ist die richtige Wahl für Laptops und Desktops, die schlafen: Wenn die Maschine aus war, als eine Auslösung fällig war, läuft der Dienst bei der nächsten Gelegenheit einmal, statt dass der Lauf still nie stattfindet — beachten Sie, dass es ein einmaliges Nachholen ist, kein Wiederholen jedes verpassten Laufs, und dass es nur für OnCalendar-Timer gilt. Und @reboot hat kein echtes Timer-Äquivalent: OnBootSec=, das eine feste Zeit nach dem Booten auslöst, ist die nächstliegende Entsprechung, und es ist nicht identisch — es ist relativ zum Booten und nicht „einmal beim Start laufen", und in Containern wird es auf OnStartupSec= abgebildet. Wenn der Job genau einmal pro Boot laufen muss, ist OnBootSec= die Antwort, aber dokumentieren Sie den Unterschied in der Unit; tun Sie nicht so, als sei die Konvertierung exakt, wenn die Handbuchseite etwas anderes sagt.

Die Gewohnheit, zuerst zu prüfen: Konvertieren, beweisen, parallel laufen lassen, dann umstellen

Die sicherste Umstellung ist absichtlich langweilig. Konvertieren Sie, beweisen Sie mit der Tabelle der nächsten 100 Auslösungen, und lassen Sie dann — wo der Job idempotent ist — die Cron-Zeile und den Timer eine Woche lang parallel laufen und vergleichen Sie die Ergebnisse: die Logs, die Ausgaben, die Nebeneffekte. Eine Woche deckt einen vollen Wochenzyklus ab und in der Regel eine Sommerzeitgrenze oder ein Monatsende, falls eines nahe ist, und jede Auslösung, die die Beweistabelle vorhergesagt hat, erscheint im Journal neben dem Cron-Lauf, den sie verdoppelt. Erst wenn beide eine volle Woche übereinstimmen, löschen Sie die Cron-Zeile, und Sie behalten die auskommentierte Kopie in der Unit als Hinweis aus dem vorherigen Abschnitt.

Wo der Job nicht idempotent ist — er sendet Mail, belastet einen Kunden, verändert eine Datenbank — lassen Sie nicht beide laufen, denn die Verdopplung ist der Fehler, den Sie vermeiden wollen. Beweisen Sie stattdessen gründlicher: Lassen Sie die 100-Auslösungen-Tabelle über eine Sommerzeitgrenze und ein Monatsende laufen, prüfen Sie die ersten abweichenden Zeilen von Hand und stellen Sie in einem Schritt um, mit der alten Zeile als Kommentar in der Unit. Prüfen Sie dann die fertige Unit so, wie Sie jede andere prüfen würden: Bewerten Sie sie mit dem systemd-Unit-Auditor und lesen Sie den Begleitartikel So härten Sie systemd-Dienste, denn ein migrierter Timer erbt dieselben Sandbox-Fragen wie jede andere Unit. Halten Sie Timer, Dienst und Beweis in der Versionskontrolle — ein Zeitplan, der nur auf einer Maschine lebt, ist einen Neuaufbau davon entfernt, vergessen zu werden.

Quellen

Häufige Fragen

Ist OnCalendar nur Cron mit anderer Syntax?

Nein — die Syntax überschneidet sich, aber die Semantik unterscheidet sich an den Stellen, die zählen. Cron verknüpft Tag des Monats und Wochentag per ODER, wenn beide eingeschränkt sind; OnCalendar per UND. OnCalendar unterstützt Sekunden, Datumsbereiche wie 01..07, Wochentagsbereiche, Zeitzonen und die Letzter-Tag-des-Monats-Syntax mit „~" — nichts davon kann eine fünfteilige Cron-Zeile ausdrücken. Es unterstützt auch mehrere OnCalendar-Zeilen in einer Unit und monotone Timer wie OnBootSec=. Die meisten einfachen Zeitpläne lassen sich sauber übersetzen; die Fallen sind DOM+DOW-Kombinationen, Sekunden, @reboot und Datumsbereiche, und genau diese Fälle kennzeichnet der Konverter, statt zu raten.

Was passiert mit einer Timer-Auslösung in der Lücke der Sommerzeitumstellung im Frühjahr?

Die Handbuchseiten sagen es nicht. crontab(5) ist für Cron ausdrücklich: Ein Job, der in der fehlenden Stunde geplant ist, läuft nie, und ein Job, der in der wiederholten Stunde geplant ist, läuft zweimal. systemd.time(7) und systemd.timer(5) enthalten keine äquivalente Regel für OnCalendar, also nehmen Sie nicht an, dass ein Timer sich um 02:30 am Tag der Frühjahrsumstellung wie Cron verhält. Die ehrliche Prüfung ist die Beweistabelle: Erzeugen Sie die nächsten 100 Auslösungen über die Sommerzeitgrenze hinweg im Konverter und lesen Sie, was tatsächlich geschieht. Wenn der Job zeitkritisch ist, ist die sicherste Wahl, ihn vollständig außerhalb von 02:00–03:00 zu planen.

Kann ich Cron und den Timer während der Migration parallel laufen lassen?

Ja, wenn der Job idempotent ist — also sicher zweimal mit demselben Ergebnis läuft. Lassen Sie beide eine Woche laufen, vergleichen Sie Logs und Ausgaben und löschen Sie die Cron-Zeile erst, wenn beide übereinstimmen. Wenn der Job nicht idempotent ist — er sendet Mail, nimmt eine Zahlung entgegen oder verändert Zustand — lassen Sie nicht beide laufen, denn der doppelte Lauf ist selbst der Fehler. Beweisen Sie in diesem Fall den Zeitplan mit der 100-Auslösungen-Tabelle, stellen Sie in einem Schritt um und behalten Sie die alte Cron-Zeile als Kommentar in der Unit, damit die Konvertierung prüfbar bleibt.