Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 13: cron und systemd-Timer

Ziel: Skripte zeitgesteuert laufen lassen – mit cron und mit systemd-Timern –, die andere Umgebung dabei verstehen, Ausgaben ins Journal schreiben und Fehlläufe erkennen. Am Ende sichert ein Timer notes jede Nacht. · Dauer: ca. 90 min · Voraussetzung: Tag 12

Briefing

  • cron startet Befehle nach einem Zeitplan aus fünf Feldern: Minute, Stunde, Tag, Monat, Wochentag. Jeder Benutzer hat eine eigene crontab.
  • cron startet mit fast leerer Umgebung: ein Standard-PATH, kein env.sh, keine Aliase, als Shell /bin/sh. Der häufigste Grund, warum ein Skript „im Terminal läuft, aber nicht in cron”.
  • systemd-Timer sind die moderne Alternative: eine .service-Einheit beschreibt, was läuft, eine .timer-Einheit wann. Ausgaben landen im Journal, verpasste Läufe werden nachgeholt, und systemctl zeigt Erfolg oder Fehler des letzten Laufs.
  • Als normaler Benutzer arbeitest du mit systemctl --user. Damit deine Timer auch ohne Anmeldung laufen, braucht es Linger.
 crontab:  */1 * * * *  . env.sh && notes-backup …  ─► logs/backup.log
 systemd:  notes-check.timer (alle 2 min) ─► notes-check.service ─► Journal
           notes-backup.timer (02:30, Persistent) ─► notes-backup.service

Drill 1: Die Umgebung von cron

source ~/sh-lab/setup/env.sh
mkdir -p ~/sh-lab/tag13 ~/sh-lab/logs && cd ~/sh-lab/tag13
crontab -l 2>&1
echo "* * * * * env | sort > $HOME/sh-lab/tag13/cron-env.txt" | crontab -
crontab -l
sleep $((62 - $(date +%S | sed 's/^0//')))
cat cron-env.txt

Erwartet (nach etwa einer Minute):

no crontab for ubuntu
* * * * * env | sort > /home/ubuntu/sh-lab/tag13/cron-env.txt
HOME=/home/ubuntu
LANG=C.UTF-8
LOGNAME=ubuntu
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local…
PWD=/home/ubuntu
SHELL=/bin/sh

Sechs Zeilen statt der Dutzenden in deinem Terminal: Kein NOTES_URL, kein NOTES_API_KEY, und ~/sh-lab/werkzeug/bin fehlt im PATH. SHELL=/bin/sh heißt: Die Zeile in der crontab läuft in dash.

Fortschritt speichern? Kostenlos registrieren

Drill 2: Ein Backup per cron

Zwei Einträge – der naive und der richtige:

crontab - <<'EOF'
# notes – Werkzeugkasten (Tag 13)
SHLAB=/home/ubuntu/sh-lab
* * * * * notes-backup -k 5 >> $SHLAB/logs/cron-naiv.log 2>&1
* * * * * . $SHLAB/setup/env.sh && notes-backup -k 5 >> $SHLAB/logs/backup.log 2>&1
EOF
crontab -l | grep -c notes-backup
sleep $((70 - $(date +%S | sed 's/^0//')))
cat ~/sh-lab/logs/cron-naiv.log
sed -E 's/^[0-9:]{8}/…/; s/[0-9]{8}-[0-9]{6}/JJJJMMTT-HHMMSS/' \
  ~/sh-lab/logs/backup.log | cut -c1-80

Erwartet:

2
/bin/sh: 1: notes-backup: not found
… notes-backup: INFO gesichert: /home/ubuntu/sh-lab/backups/notes-JJJJMMTT-HHMMS
  • Der naive Eintrag findet notes-backup nicht – PATH von cron kennt den Werkzeugkasten nicht. Ohne >> datei 2>&1 hätte cron die Meldung per Mail verschickt, und ohne Mailserver wäre sie still verschwunden.
  • . statt source: cron läuft in sh, und dash kennt source nicht. env.sh ist bewusst POSIX-konform geschrieben.
  • SHLAB=… setzt eine Variable für alle folgenden Zeilen. cron selbst ersetzt darin nichts, deshalb steht der Pfad ausgeschrieben; in den Befehlen ersetzt sie sh.
  • Den Rest erledigt notes-backup selbst: Sperre gegen Doppelläufe, Rotation, Exit-Code.

Jede Minute ein Backup ist zu viel – weg damit:

crontab -r && crontab -l 2>&1

Erwartet:

no crontab for ubuntu

Fortschritt speichern? Kostenlos registrieren

Drill 3: logger und das Journal

logger -t notes-werkzeug -p user.warning "Plattenplatz knapp (Test)"
journalctl -t notes-werkzeug -n 1 --no-pager -o cat
journalctl -t notes-werkzeug -p warning --since "-5min" --no-pager | wc -l

Erwartet:

Plattenplatz knapp (Test)
1

logger schreibt ins Systemlog, -t setzt die Kennung, -p die Stufe. journalctl -t filtert danach, -p warning zeigt nur Warnungen und Schlimmeres.

Fortschritt speichern? Kostenlos registrieren

Drill 4: Ein systemd-Timer

mkdir -p ~/.config/systemd/user
cat > ~/.config/systemd/user/notes-check.service <<'EOF'
[Unit]
Description=Prüft, ob notes antwortet

[Service]
Type=oneshot
Environment=NOTES_URL=http://127.0.0.1:8080
ExecStart=%h/sh-lab/werkzeug/bin/notes-check -v
EOF
cat > ~/.config/systemd/user/notes-check.timer <<'EOF'
[Unit]
Description=notes alle zwei Minuten prüfen

[Timer]
OnBootSec=1min
OnUnitActiveSec=2min

[Install]
WantedBy=timers.target
EOF
sudo loginctl enable-linger "$USER"
systemctl --user daemon-reload
systemctl --user enable --now notes-check.timer 2>&1 | tail -1
systemctl --user start notes-check.service
systemctl --user list-timers --no-pager | grep -c notes-check
journalctl --user -u notes-check -n 4 --no-pager -o cat
systemctl --user show notes-check.service -p Result -p ExecMainStatus

Erwartet:

Created symlink '/home/ubuntu/.config/systemd/user/timers.target.wants/notes-check.time…
1
200 /notes
200 /version
3 ok, 0 Fehler
Finished notes-check.service - Prüft, ob notes antwortet.
Result=success
ExecMainStatus=0
  • Der Service sagt was, der Timer wann. OnUnitActiveSec=2min heißt: zwei Minuten nach dem letzten Lauf wieder.
  • %h ist das Home-Verzeichnis. systemd kennt weder ~ noch env.sh – Variablen stehen ausdrücklich unter Environment=.
  • Alles, was das Skript auf stdout und stderr schreibt, landet im Journal, mit Zeit und Einheit. Keine eigenen Log-Dateien nötig.
  • enable-linger lässt deine Benutzer-Units auch laufen, wenn du nicht angemeldet bist.

Fortschritt speichern? Kostenlos registrieren

Drill 5: Fehlläufe erkennen

docker compose -f ~/sh-lab/notes/compose.yaml stop proxy >/dev/null 2>&1
systemctl --user start notes-check.service; echo "start: $?"
systemctl --user show notes-check.service -p Result -p ExecMainStatus
systemctl --user --failed --no-pager --plain | grep -o 'notes-check.service.*failed'
docker compose -f ~/sh-lab/notes/compose.yaml start proxy >/dev/null 2>&1
notes-wait 10 >/dev/null && systemctl --user start notes-check.service
systemctl --user show notes-check.service -p Result

Erwartet:

Job for notes-check.service failed because the control process exited with error code.
See "systemctl --user status notes-check.service" and "journalctl --user -xeu notes-che…
start: 1
Result=exit-code
ExecMainStatus=1
notes-check.service loaded failed failed
Result=success

Der Exit-Code von notes-check wird zum Zustand der Einheit. Ein Monitoring braucht nur noch systemctl --failed abzufragen – oder die Einheit bekommt OnFailure= mit einer Einheit, die eine Nachricht verschickt.

Fortschritt speichern? Kostenlos registrieren

Kontrollpunkt

systemctl --user is-enabled notes-check.timer

Erwartet:

enabled
crontab -l 2>&1

Erwartet:

no crontab for ubuntu
loginctl show-user "$USER" -p Linger

Erwartet:

Linger=yes

Challenge

Richte das nächtliche Backup als Timer ein: täglich um 02:30, -k 14, und wenn die VM um diese Zeit aus war, holt systemd den Lauf beim nächsten Start nach. Prüf den Zeitausdruck vorher mit systemd-analyze calendar.

Hinweis: OnCalendar= und Persistent=true. notes-backup braucht docker im PATH – den Standard-PATH von systemd hat es.

Lösung

systemd-analyze calendar '*-*-* 02:30' | grep -E 'Normalized|Next' \
  | sed -E 's/Next.*/Next …/'
cat > ~/.config/systemd/user/notes-backup.service <<'EOF'
[Unit]
Description=Sichert die Datenbank von notes

[Service]
Type=oneshot
ExecStart=%h/sh-lab/werkzeug/bin/notes-backup -k 14
EOF
cat > ~/.config/systemd/user/notes-backup.timer <<'EOF'
[Unit]
Description=notes jede Nacht sichern

[Timer]
OnCalendar=*-*-* 02:30
Persistent=true

[Install]
WantedBy=timers.target
EOF
systemctl --user daemon-reload
systemctl --user enable --now notes-backup.timer 2>/dev/null
systemctl --user start notes-backup.service && journalctl --user -u notes-backup -n 2 \
  --no-pager -o cat | sed -E 's/^[0-9:]{8}/…/; s/[0-9]{8}-[0-9]{6}/JJJJMMTT-HHMMSS/' \
  | cut -c1-80
systemctl --user list-timers --no-pager | grep -c 'notes-'

Erwartet:

Normalized form: *-*-* 02:30:00
    Next …
… notes-backup: INFO gesichert: /home/ubuntu/sh-lab/backups/notes-JJJJMMTT-HHMMS
Finished notes-backup.service - Sichert die Datenbank von notes.
2

Persistent=true merkt sich den letzten Lauf auf der Platte: Ist der Zeitpunkt verpasst, startet der Timer gleich nach dem Booten. cron kann das nicht.

Fortschritt speichern? Kostenlos registrieren

Enterprise-Notiz

  • Zeitzonen: cron und systemd rechnen in der Zeitzone des Servers. Server laufen besser in UTC; OnCalendar=*-*-* 02:30 Europe/Berlin legt die Zone ausdrücklich fest.
  • Nicht alle zur selben Minute: Hundert Server, die um 02:30 gleichzeitig sichern, legen das Backup-Ziel lahm. RandomizedDelaySec=30min verteilt die Läufe.
  • Überwachen statt hoffen: Ein Backup-Job, der nicht läuft, meldet keinen Fehler. Prüfe ausdrücklich das Alter des neuesten Backups – ein Fall für notes-check oder einen Exporter fürs Monitoring.